BGFI RDC PAYMENT GATEWAY



image


POST 0-1- get Token image


https://rdc-api2-partenaire-test.omnitechafrica.com//api/rakakash/oauth


Create OAuth Token


This endpoint is used to generate an OAuth token for further authentication.


Request Body


image

image

json

{

"consumerid": "",

"consumersecret": ""

}

Raw JSON



Response


image

json

{

"type": "object", "properties": {

"code": {

"type": "integer"

},

"message": {

"type": "string"

},

"token": {

"type": "string"

The response for this request can be documented as a JSON schema:



AUTHORIZATION Basic Auth

image


Username <username>


Password <password>

image

json

{

"consumerid": "wza52dc112-3df6-11ee-95bc-0050568166da",

"consumersecret": "96abfbbfeb745b63744d00d3c9e39687ba32f7ed"

}

Body raw (json)

image



image


POST 0-2 Init Payment


https://rdc-api2-partenaire-test.omnitechafrica.com//api/rakakash/initpayment


product_description

Description du paiement

merchant_name

le nom du marchand

merchant_id

id du marchand

amount

Montant du

currency


rakakash_number


merchant_logo


callback_url



Pour initier un paiement :


NB : Pour chaque Initiation de paiement vous allez renseigner :


image

le token obtenu lors de la génération de Token (Service 0-1)

image

vous devez renseigner le callback_url : nous vous ferons un retour sur ce lien 3 secondes aprés le paiement.



image

json

{

"product_description": "Achat de carburant de 100 ", "merchant_name": "PETRO CONGO",

"merchant_id": "983489743",

"amount": "5",

"currency": "USD", "rakakash_number": "243999061084",

"merchant_logo": "https://petrocongo.cg/wp-content/uploads/2020/09/logobig.png", "callback_url": "https://petrocongo.cg",

"external_id": "TRAN87879879797"

}

En UAT le code OTP est précisé dans la clé message du retour .

Le qrcode est généré en meme temps que l'otp , le client et le marchand auront le choix pour finaliser le paiement.


Le qrcode vient sous deux formes :


image

image

Une image (http) que vous pourrez presenter dans une interface web pour un scan Un numéro qrcode_text que vous pourrez transformer en QrCode

image

Tous les deux options seront pris en compte lors du scan depuis Rakakash


Nous allons rajouter un service GetStatus qui vous permettra de savoir le statut d'une transaction a partir du codetransaction.


HEADERS

image


Authorization


image

json

{

"product_description": "Facture AS-172", "merchant_name": "DIGIS ASSUR", "merchant_id": "DIGIS01",

"amount": "50",

"currency": "USD", "rakakash_number": "243999061084",

"merchant_logo": "https://digis-assur.weelitre.pro/_next/image/?url=%2F_next%2Fstatic%2 "callback_url": "https://digis-assur.weelitre.pro",

"external_id": "DIGIS01-29325691"

}

Body raw (json)

image



image


POST 0-3 Confirm Payment


https://rdc-api2-partenaire-test.omnitechafrica.com//api/rakakash/confirmpayment


Username : minisenv

Password : passer


consumerid : 2c8730a98-f1cb-11e6-af89-fc15b48e1b50

consumersecret : tWDaPZhRExQR10Udc9HRcyxFJw8a7v3f



HEADERS

image


Authorization

image

json

{

"otp_code": "333451",

"codetransaction":""

}

Body raw (json)

image



image


GET 0-4 Status Transaction


https://rdc-api2-partenaire-test.omnitechafrica.com//api/rakakash/status/


Etat d'un paiement marchand ou d'un virement initié.


Les etats possibles sont :


image

image

image

PAYE : transaction confirmée et payée par le client ou virement effectué. EXPIRED : Transaction expirée (aprés 30 secondes d'attente) NOTFOUND : transaction introuvable sur la plateforme

image

ENATTENTE : En attente de confirmation



HEADERS

image


Authorization


image


POST 0-5 Init Virement


https://rdc-api2-partenaire-test.omnitechafrica.com//api/rakakash/deposit


HEADERS

image


Authorization


image

json

{

"nombanquedestination": "BGFIBANK RDC ",

Body raw (json)

image



image


image

"beneficiaire": "Ruboneka Patrick", "libelle": "Paiement PARTENAIRE 94398349 ", "mercbeneficiairehant_name": "JUMIA",

"codebanquedestination": "00031",

"codeguichetdestination": "26900 ",

"comptedestination": "90014467011",

"montantvirement": "100", "devise": "USD",

"callback_url": "https://webapi-test.maxicashapp.com/Integration/BgfiCallback"

}

POST 0-5-1 Depot vers un compte Rakakash


https://rdc-api2-partenaire-test.omnitechafrica.com//api/rakakash/deposit/rakakash


HEADERS

image


Authorization


image

json

{

"compterakakash_destinataire": "243810593933", "devise": "USD",

"montant": 5

}

Body raw (json)

image



image


POST 0-6 Vérification compte


https://rdc-api2-partenaire-test.omnitechafrica.com//api/rakakash/checkaccount


Vérification d'un compte Rakakash ou Bancaire


image

"type": "BANK",

"account": "90000033012",

"codeguichet": "26900",

"rib": "13"


image

image

Type prend les valeurs suivantes "BANK" ou "RAKAKASH" account represente le compte a rechercher


NB : La vérification de compte bancaire n'est pas exaustive , nous ne pouvons faire la vérification que pour les abonnés banking , il y'a une grand partie des clients BGFI RDC qui sont pas encore souscrit .

Nous vous conseillons de l'utiliser qu'a titre informatif .


HEADERS

image


Authorization


image

json

{

"type": "BANK", "account": "90000033012",

"codeguichet": "26900",

"rib": "13"

}

Body raw (json)

image



image


POST TEST CALLBACK


SRV_PARTENAIRE


image

json

{

"codetransaction": "MKT9124584559", "product_description": "Achat IN STREET", "merchant_name": "IN STREET", "merchant_id": "243903900686", "currency": "USD",

"rakakash_number": "243824310842",

"merchant_logo": "https://makuta.cash/img/corporations/644bc82eafcd3625736981.png", "etat": "EXPIRE",

"montant": "1.52",

"message": "Transaction expir□e !", "datecreation": "2024-02-22 10:21:06",

"external_id": "1EED163B-48E8-6F30-88A7-194D4BD6F473"

}

Body raw (json)

image