Page de paiement Yabetoo Pay

Vous pouvez suivre les indications ci-dessous pour implémenter notre page de paiement. En utilisant cette méthode vous pouvez accepter les paiements Mobile Money en seulement 15min.

Avec notre page de paiement vos clients auront accès à tous les types de paiements proposés par Yabetoo Pay, ainsi que ceux qui seront proposés à l'avenir sans que vous n'ayez à faire quoi que ce soit.

Étape 1 : Token d'authentification

Vous devez récupérer votre clé secrète comme indiquer dans l'introduction. cette clé est strictement confidentiel et ne doit pas être communiquer à un tiers.

Introduction

Étape 2 : Checkout Session

Cette étape vous permet d'envoyer les informations concernant votre panier à Yabetoo Pay qui les affichera à vos clients, Cela vous permet également par la suite d'avoir des statistiques sur vos produits vendus dans votre espace personnel.

POST https://buy.api.yabetoopay.com/v1/sessions

Chaque transaction effectuée est authentifiée par un token à usage unique, sans ce token toutes transactions seront rejetées.

Headers

Name	Type	Description
Authorization*	string	Bearer :secretKey

Request Body

Name	Type	Description
items*	array	array d'object. voir la section products ci-dessous
successUrl*	string	url de redirection en cas de succès
cancelUrl*	string	url de redirection en cas d'échec
currency*	string	XFA ou FCFA
metadata	object	vous pouvez y mettre des informations dont vous jugez nécéssaire
total	number	prix total du panier
accountId	string

200

{
    "accountId": "acct_iNXIGeot1lqyhGI5eP7KL0LcWTCTgFLytfRa",
    "successUrl": "https://monsite.com/checkout-success",
    "cancelUrl": "https://monsite.com/checkout-cancel",
    "orderId": "ord_KowaIWyMlD25Lhb8MyY3GQyvN8nFaxTZ7ji7",
    "expiresAt": "2024-05-28T13:33:51.760+00:00",
    "id": "session_ajrw3pQUUZD8UI2eFkWyUgLxJ4kGuXCoaQeb",
    "createdAt": "2024-05-28T12:33:51.762+00:00",
    "updatedAt": "2024-05-28T12:33:51.762+00:00"
}

401

unauthorized

Items

items: [
 {
    "productId": "prt_XoPjNH2l5Q1g19mIZPxqYWEXwRJzOmlNXhcb",
    "quantity": 1,
    "price": 200000,
    "productName": "Écran LG"
 }
]

Metadata

metadata: {
    "orderId": 12
}

Étape 3 : Page de paiement

Rediriger vos clients vers la page de paiement comme ci-dessous

Page de paiement

Cette requête vous permet de générer l'url de paiement, vous devez ensuite faire une redirection coté client vers celle-ci afin que vos clients puissent procéder au paiment.

Mode

Sandbox (test)

Url

https://checkout.yabetoopay.com/{session_uuid}

Méthode

GET

Mode

Production

Url

https://checkout.yabetoo.com/{session_uuid}

Méthode

GET

Redirection du client

Apres paiement le client sera redirigé vers l'adresse spécifié dans le callback

Notre système rajoutera l'ID de la transaction à votre callback comme ceci : https://your_callback?paymentId={id} il est dans votre interêt de vérifier la bonne reception du paiement en verifiant le status de celui-ci dans notre système en procédant comme ceci :

Transaction status

Mode

Sandbox (test)

Url

https://pay.sandbox.yabetoopay.com/v1/payment-intents/{paymentId}

Méthode

GET

Mode

production

Url

https://pay.api.yabetoopay.com/v1/payment-intents/{paymentId}

Méthode

GET

Path Parameters

Name	Type	Description
paymentId*	string	L'ID qui vous sera donné via votre callback

Headers

Name	Type	Description
Authorization*	string	Bearer {token} //token généré a l'étape 1

200

{
    "status": "succeeded",
}

Le lien ci-dessous vous permet de trouver les numéros tests qui vous serviront à tester différent cas d'utilisation.

Testing