Aller au contenu principal

Cartes bancaires​

Les cartes bancaires sont parmis les moyens de paiement en ligne les plus populaires dans le monde. Il existe différents types de cartes bancaires et plusieurs étapes de paiement. Découvrez comment fonctionne un paiement par carte bancaire en ligne.

Info
Info

Pour accepter des paiements par carte, il faut préparer et envoyer les bonnes informations. Ensuite un lien vers une page de paiement est reçu. Redirigez vos clients vers cette page pour vous faire payer

Initier un paiement par carte avec l'API​

Pour initier un paiement par carte, vous devez transmettre des informations telles que le nom, le prénom, l'email, le montant, etc.

Vous pouvez également transmettre un autre paramètre qui est l'URL à contacter lorsque la transaction change d'état. Certains paramètres sont obligatoires et d'autres non. Consultez le tableau suivant pour en savoir plus


ParamètreRequis?Description
senderPhoneNumberOuiNuméro du client
Il dois respecter le format E.164 sans le signe +.
Format: [country code][local phone number]
Ex: 22951010588
senderFirstNameOuiPrénom du client
senderLastNameOuiNom de famille du client
amountOuiMontant à récupérer chez le client
currencyOuiDevise Voir les devises supportées
titleOuiTitre du client. Ex: Mr, Dr
emailOuiEmail du client
addressOuiAdresse du client
localityOuiLocalité du client
districtOuiDistrict du client
postalCodeOuiCode postal du client
webhookUrlNonURL que nous allons contacter pour vous notifier des mises à jour par rapport au paiement initié.
successRedirectionUrlNonUrl de redirection en cas de réussite du paiement
errorRedirectionUrlNonUrl de redirection en cas d'échec du paiement

POST https://apis.chipdeals.me/momo/requestpayment?apikey=test_FOdigzgSopV8GZggZa89 HTTP/1.1content-type: application/json{  "senderFirstName": "Iyam",  "senderLastName": "EVERICH",  "senderPhoneNumber": "22951010588",  "amount": 250,  "currency": "XOF",  "title": "Mr",  "email": "myuser@gmail.com",  "address": "Cotonou",  "locality": "Litoral",  "district": "BJ",  "postalCode": "229",  "successRedirectionUrl":"https://webhook.site/3896e3d6-7014-42f3-a394-a91a04edb367/success",  "errorRedirectionUrl":"https://webhook.site/3896e3d6-7014-42f3-a394-a91a04edb367/error"}
Réponse obtenue
HTTP/1.1 200 OKcontent-type: application/jsondate: Tue, 22 Nov 2022 18:31:44 GMTconnection: closeX-Powered-By: Chipdeals Inc{  "success": true,  "message": "",  "payment": {    "reference": "498a8055-1e94-48aa-ba25-703bb8e74ba7",    "senderPhoneNumber": "22951010588",    "senderCountryCode": "BJ",    "senderOperator": "CARD",    "senderFirstName": "Iyam",    "senderLastName": "EVERICH",    "originalCurrency": "XOF",    "currency": "XOF",    "status": "pending",    "statusMessage": "Waiting user validation",    "statusMessageCode": 204,    "startTimestampInSecond": 1669141903,    "endTimestampInSecond": 0,    "amount": 250,    "originalAmount": 250,    "transactionType": "payment",    "checkoutUrl": "https://apis.chipdeals.me/momo/checkout/3def8342-feca-4bde-b2d6-2b04715e4f1f/index.html",    "successRedirectionUrl": "https://webhook.site/3896e3d6-7014-42f3-a394-a91a04edb367/success",    "errorRedirectionUrl": "https://webhook.site/3896e3d6-7014-42f3-a394-a91a04edb367/error"  }}


Lien de redirection​

Le cycle de vie classique de l’expérience de paiement d’un client se déroule comme suit :

  1. Quand vos clients sont prêts à finaliser leurs achats, votre application doit permettre d'introduire leurs informations puis faire une requête vers Chipdeals.
  2. La réponse fournie une URL avec la propriété checkoutUrl en réponse. Redirigez vos clients vers cette page de paiement hébergée par Chipdeals.
  3. Vos clients saisissent leurs informations de paiement sur la page dédiée et finalisent la transaction.
  4. Après validation de la transaction, une redirection est faite vers la page de redirection soumise dans la propriété successRedirectionUrl ou errorRedirectionUrl selon l'état de la transaction. Un webhook est ensuite déclenché si disponible.


Environnement de test​

Nous ne saurions trop insister là-dessus : veuillez tester nos APIs par rapport à notre environnement sandbox avant de les diriger vers la production. Nous préférons éviter les interruptions de service en production causées par du code non testé.

Pour tester le fonctionnement des paiements par carte bancaire, veuillez utiliser ces numéros de cartes factices.

Chaque numéro de carte correspond a un cas précis du status de la transaction.


Numero testCas testé
4556 3304 3448 0100Vos informations sont mal remplies. Veuillez relancer le paiement
4539 7343 2895 5261Impossible d'effectuer ce paiement. Veuillez réessayer plus tard
4111 1111 1111 1111Paiement réussi


Authentification du client​

Certaines banques, notamment dans certaines régions plus réglementées, invitent leurs clients à authentifier leurs achats (par exemple en leur envoyant par SMS un code qu’ils doivent ensuite saisir sur le site Web de la banque). Nous redirigons automatiquement vos clients vers cette page lorsque necessaire.


Authentification d'un client


Autorisation​

La banque vérifie que le client dispose des fonds suffisants. Si c'est le cas ces fonds sont virés sur le compte du marchand chez nous. Ils seront pleinement disponibles pour un virement après 48h. Le cas échéant, la banque nous renvoie un echec de paiement.



Paiement effectué​

Les fonds passent de la banque émettrice au compte du marchand.