Accepter un paiement
Initiez un paiement mobile money avec l'endpoint suivant.
Endpoint
POST
https://api.openpay-cg.com/v1/transaction/payment Paramètres de la requête
| Paramètre | Type | Requis | Description |
|---|---|---|---|
| amount | number | Obligatoire | Montant de la transaction en XAF |
| payment_phone_number | string | Obligatoire | Numéro de téléphone du client (format: 242XXXXXXXXX) |
| provider | string | Obligatoire | Opérateur mobile : MTN |
| customer_external_id | string | Optionnel | ID unique du client dans votre système |
| customer | object | Optionnel | Informations du client (name, phone) |
| metadata | object | Optionnel | Données additionnelles pour votre usage |
amountObligatoirenumber
Montant de la transaction en XAF
payment_phone_numberObligatoirestring
Numéro de téléphone du client (format: 242XXXXXXXXX)
providerObligatoirestring
Opérateur mobile : MTN
customer_external_idOptionnelstring
ID unique du client dans votre système
customerOptionnelobject
Informations du client (name, phone)
metadataOptionnelobject
Données additionnelles pour votre usage
Exemple de requête
JSON body
{
"amount": 1,
"payment_phone_number": "242066203420",
"customer_external_id": "1111",
"customer": {
"name": "azerty",
"phone": "242066203420"
},
"provider": "MTN",
"metadata": {
"order_id": "123456",
"customer_name": "Jean Dupont"
}
}Réponse de succès
JSON200 OK
{
"reference": "PTXN26042237B99A5D9",
"amount": "1000",
"currency": "XAF",
"paymentPhoneNumber": "242066203420",
"provider": "MTN",
"type": "payment",
"status": "success",
"metadata": null
}