APINovasend
Transfert
Initier un transfert marchand et suivre son statut.
POST https://business.novasend.app/v1/payoutCet endpoint permet à un marchand d'initier un payout, c'est-à-dire un transfert de fonds depuis son portefeuille vers un bénéficiaire externe.
En-tête de la Requête
| Valeur | Description | Obligatoire |
|---|---|---|
| Authorization | Pour authentifier l'Api, Basic base64(api_key:api_client) | ✅ |
| X-Idempotency-Key | Cet en-tête garantit l'unicité de vos transactions. La valeur doit être un UUID | ✅ |
| Content-Type | application/json | |
| Accept-Language | Pour traduire les messages d'erreur, langues possibles: en, fr |
Requête
| Champ | Type | Description | Obligatoire |
|---|---|---|---|
reference | string | Identifiant unique du transfert (UUID côté marchand). | ✅ |
amount | number | Montant à transférer. | ✅ |
msisdn | string | Numéro de téléphone du bénéficiaire (format E.164). | ✅ |
country | string | Code ISO du pays (CI, CM). | ✅ |
customerName | string | Nom du bénéficiaire. |
{
"reference": "55a4e677-5700-4ed0-9a2a-9300db894ddb",
"amount": 300,
"msisdn": "+225000000000",
"country": "CI",
"customerName": "Habib"
}Réponse
{
"id": "pr_bawy28jjce5btvu8eq1jjvmjlt",
"type": "payout",
"reference": "036065a8-081f-46f7-916f-3c4ba24b64a4",
"status": "processed",
"confirmationRequired": false,
"confirmationStatus": "accepted",
"paymentUrl": null,
"customer": {
"name": "Konan khan",
"phoneNumber": "+225000000000"
},
"isDirect": false,
"payFee": false,
"createdAt": "2026-01-19T09:11:42.594Z",
"amount": 200,
"fee": 4,
"chargedAmount": 204,
"currency": "XOF",
"failure": null
}Interprétation de la Réponse
| Champ | Description |
|---|---|
| id | Identifiant unique du transfert (payout). |
| type | Type de transaction — ici payout (transfert sortant). |
| reference | Référence fournie par le marchand pour identifier le transfert. |
| status | Statut global du transfert (processing, processed, expired, etc.). |
| confirmationRequired | Indique si une confirmation du bénéficiaire est requise avant l'exécution du transfert. |
| confirmationStatus | État actuel de la confirmation (none, pending, accepted, declined). |
| paymentUrl | Lien de confirmation du transfert (null si non applicable). |
| isDirect | Indique si le transfert a été initié via un flux direct. |
| payFee | Indique si les frais sont pris en charge par le marchand. |
| createdAt | Date et heure de création du transfert. |
| amount | Montant du transfert (hors frais). |
| fee | Montant des frais de service appliqués. |
| chargedAmount | Montant total débité du compte marchand (montant + frais). |
| currency | Devise utilisée (XOF, USD, EUR, etc.). |
| failure | Détails de l'erreur en cas d'échec du transfert (null en cas de succès). |
customer
| Champ | Description |
|---|---|
| name | Nom du client. |
| phoneNumber | Numéro de téléphone du client (format international). |
Statut du transfert
GET https://business.novasend.app/v1/payout/{reference}Cet endpoint permet de consulter à tout moment l'état d'un transfert.
Réponse
{
"id": "pr_bawy28jjce5btvu8eq1jjvmjlt",
"type": "payout",
"reference": "036065a8-081f-46f7-916f-3c4ba24b64a4",
"status": "processed",
"confirmationRequired": false,
"confirmationStatus": "accepted",
"paymentUrl": null,
"customer": {
"name": "Konan khan",
"phoneNumber": "+225000000000"
},
"isDirect": false,
"payFee": false,
"createdAt": "2026-01-19T09:11:42.594Z",
"amount": 200,
"fee": 4,
"chargedAmount": 204,
"currency": "XOF",
"failure": null
}