...
App calls
/transact
with the right auth detailsProvider responds with
WaitingForOTP
orPendingValidation
as may be requiredApp calls
/transact/validate
to supply OTP if neededProvider responds with any of the completion codes
Successful
orFailed
.To query the status of a transaction, the app can call
/transact/query
Where the provider supports it, the app can call
/transact/reverse
to request a reversal
Gliffy | |
---|---|
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
INTERFACE SPECIFICATION (APP → ONEPIPE)
...
Code Block | ||
---|---|---|
| ||
{ "request_ref":"{{request_ref}}", "request_type":"get_balance", "auth": { "type": "bank.account | card | wallet | msisdn", "secure": "{{encrypted(bank account number | card details | wallet | msisdn)}}", "auth_provider": "Beeceptor", "route_mode": null }, "transaction": { "mock_mode": "live", "transaction_ref": "{{transaction_ref}}", "transaction_desc": "A random transaction", "transaction_ref_parent": null, "amount": 0, "customer":{ "customer_ref": "{{customer_id}}", "firstname": "Uju", "surname": "Usmanu", "email": "ujuusmanu@gmail.com", "mobile_no": "234802343132" }, "meta":{ "a_key":"a_meta_value_1", "another_key":"a_meta_value_2" }, "details": null } } |
...
Code Block | ||
---|---|---|
| ||
{ "status": "Successful", "message": "Transaction processed successfully", "data": { "provider_response_code": "00", "provider": "Beeceptor", "errors": null, "error": null, "provider_response": { "account_id": "50617644717007", "cardaccount_type": "VerveCurrent", "account_number": "6200000766", "avialableavailable_balance": 2077099, "ledger_balance": 2077099, "minimum_balance": 0, "account_class": "STFCUR", "account_status": "ACCOUNT OPEN", "currency": "NGN", "reference": "000022200225154318222333334432", "meta":{ "field_key":"field_value", "field_key":"field_value" } } } } |
Request (validate with otp)
...