Passer au contenu principal
POST
Créer une demande de paiement

Autorisations

Authorization
string
header
requis

Saisissez votre clé API commençant par gtw_sk_

Corps

application/json
targetAmount
number
requis

Montant cible du paiement

Exemple:

35000

sourceCurrency
string
requis

Code de devise source ISO 4217

Exemple:

"EUR"

targetCurrency
string
requis

Code de devise cible ISO 4217 (devise de retrait prise en charge)

Exemple:

"NGN"

reference
string
requis

Référence de paiement unique (obligatoire).

customerId
string<uuid>
requis

Identifiant du client pour associer le paiement à un client spécifique (obligatoire).

description
string
Exemple:

"Monthly subscription"

payerName
string
payerEmail
string
redirectUrl
string

URL de redirection après l'autorisation du paiement

provider
string

Prestataire d'encaissement facultatif. Utilisez opay pour les paiements par carte ou virement en NGN lorsque ce prestataire est activé.

paymentType
string

Indication facultative du type de paiement (DOMESTIC_PAYMENT par défaut).

paymentMethods
enum<string>[]

Un ou plusieurs modes de paiement que le payeur peut utiliser.

Minimum array length: 1
Options disponibles:
bank_transfer,
card,
crypto,
mobile_money
metadata
object

Réponse

Paiement créé. Renvoie un linkToken, une checkoutUrl ou un paymentLink hébergé à partager avec le payeur pour autoriser le paiement.