Paiements

Initier un paiement sur un objet paymentRequest

Il s'agit du endpoint à utiliser chaque fois que vous souhaitez initier un paiement sur une requête de paiement. Il créera un objet de paiement associé à la requête qui contiendra toutes les informations sur le paiement.

curl --location --request POST 'https://rest-airtime.paysecurehub.com/api/mrchd_ws/paymentReq/{pmId}/payments' \
--header 'ApiKey: [REDACTED]' \
--header 'MerchantId: [REDACTED]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "tokens": "MTcyNzU2OTAwNENkTjlSQjdCd3c0RDVNZXd6dFJrbzBmWjhHVzhvUU5ZajZmMDhad1c4ZFdRR2RY",
    "service_id": 17,
    "msisdn": "0757411021",
    "Url_Callback": "https://nom_de_domaine/end_point_notification_paiement/"
}'

        

Headers

ApiKey  string   requis
Votre clé API. Transmise par mail après création de votre identifiant marchand. Si vous n'y avez pas eut accès, veuillez contacter l'équipe d'assistance.

MerchantId  string   requis
Votre identifiant marchand. Ces informations sont disponibles dans votre tableau de bord. Si vous n'y avez pas accès, veuillez contacter l'équipe d'assistance.

Paramètre

pmId  string   requis
Identifiant du PaymentRequest sur lequel de paiement sera initié.

Body

tokens  string   requis
Le tokens qui identifie une requête de paiement. Il s'agit d'un champ renvoyé lors de la création d'une demande de paiement.

service_id  number   requis
L'identifiant du provider sélectionné. Consulter la liste des provider ici providers .

msisdn  string   requis
Le numéro de téléphone associé au compte Mobile Money utilisé pour effectuer la transaction.

Url_Callback  string   requis
URL callback sert à vous notifier de façon instantané toutes les transactions concernées par l'identifiant du marchand.

om_otp  string  
Certains providers demandent au client de générer un OTP pour autoriser le paiement. Mais dans certains cas, le client préfère effectuer un processus en une seule étape dans lequel le paiement et l'authentification sont effectués en même temps. Notre solution permet cela en acceptant qu'un OTP soit fourni lors de l'étape d'initiation du paiement.
NB: A renseigner pour le provider Orange.

Reponse

{
    "pmId": "pm_a6sqxI40NDwkCU51FvyW4",
    "merchantId": "28kahrg-q0",
    "codePaiement": "sh010dfflm1l05s05",
    "BusinessName": "CIAPOL",
    "payments": {
        "transactionId": "FTB2409290017.000005",
        "amount": 300,
        "fees": 10,
        "cc": "CI",
        "msisdn": "0757411021",
        "serviceId": 17,
        "serviceName": "Wave",
        "status": "PENDDING",
        "nextAction": "Please redirect the client on the following wave url",
        "method": "get",
        "url": "https://pay.wave.com/c/cos-1rwf82b1g22mm?a=310&c=XOF&m=BMI%20FINANCE%20CI%20%2A%20Conn",
        "createdAt": "2024-09-29T00:17:22.621Z",
        "updatedAt": "2024-09-29T00:17:22.621Z"
    },
    "code": 200,
    "message": "L operation a ete initiee sur le numero 0757411021. ",
    "createdAt": "2024-09-29T00:17:22.621Z",
    "updatedAt": "2024-09-29T00:17:22.621Z"
}

        

• Le  tokens  Web Token JSON unique permettant d'initier un paiement sur le PaymentRequest sur une application côté client.
• Le  montant  montant destiné à être collecté par ce PaymentRequest. Un nombre entier positif représentant le montant à facturer dans la plus petite unité monétaire (par exemple, 100 pour facturer 100 FCFA, une devise sans décimale).
• Le  pmId  Identifiant unique du PaymentRequest
• Le  merchantId  est l'Identifiant marchand de collecte de fonds du marchand
• Le  codePaiement  Une référence fournie par le client lors de la création de ce PaymentRequest
• Le  BusinessName  Pour Agrégateur, nom du marchand.
• Le  payments  Detail du paiement initié sur ce PaymentRequest.
• Le  createdAt  Date/heure dans le fuseau horaire UTC auquel cet objet a été créé. Suit l’ISO Datetime..
• Le  updatedAt  Date/heure dans le fuseau horaire UTC auquel cet objet a été mise à jour. Suit l’ISO Datetime..

 Créer un objet paymentRequest    Statut paiement