Payment on Terminal
Execute payment
Balance
Webhooks
Payments
- GETRetrieve a PaymentIntent collection
- POSTCreate a PaymentIntent object
- GETRetrieve a PaymentIntent object
- POSTAttempt a payment on a PaymentIntent object
- POSTSynchronously attempt a payment on a payment intent
- POSTAuthenticate the current payment
- GETRetrieve fees
- GETRetrieve configured URLs
- GETRetrieve a PaymentIntent status
- GETRetrieve a Payments collection
- GETRetrieve the status payment object
Provisioning
Payment on Terminal
Transfers
Compliance
Payment on Terminal
Execute payment
POST
/
terminal
/
payments
{
"id": "pi_z1urYtVFgEebtcj8fxp4v",
"merchantId": "<string>",
"createdAt": "2020-10-15T12:09:49.355Z",
"updatedAt": "2020-10-15T12:16:26.128Z",
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtZXJjaGFudElkIjoiMTYiLCJtb2RlIjoic2FuZGJveCIsInBheW1lbnRJZCI6InBpX3oxdXJZdFZGZ0VlYnRjajhmeHA0diIsImlhdCI6MTYwMjc1OTE4M30.OZ0fDnMVWvcT-gRthyBD58PFC20gabGKt1UPRe4aNi4",
"purchaseReference": "ref_2020_11_10_001",
"customerReference": "cust_01924059",
"status": "successful",
"amount": 100,
"currency": "XOF",
"payments": [
{
"id": "pay_QW2d6JnqiatcH8KhK0mD1",
"intentId": "pi_z1urYtVFgEebtcj8fxp4v",
"createdAt": "2020-10-15T12:09:49.355Z",
"updatedAt": "2020-10-15T12:16:26.128Z",
"status": "successful",
"amount": 100,
"currency": "XOF",
"method": "credit_card",
"country": "CI",
"failure": {
"code": "internal_error",
"message": "<string>",
"params": [
"<string>"
]
},
"fees": [
{
"id": "lAe5HnFpvOjwdT9vSIgPA",
"rate": 123,
"rateType": "percent",
"amount": 5,
"currency": "XOF",
"label": "<string>",
"taxes": [
"<string>"
]
}
],
"nextAction": {
"type": "ussd",
"message": "<string>",
"data": {
"url": "<string>",
"urls": "<string>",
"method": "post",
"headers": {},
"data": {}
}
},
"providerReference": "<string>",
"gatewayId": "<string>",
"number": "<string>",
"onSuccessRedirectionUrl": "https://my.website.com/cancel",
"onFailedRedirectionUrl": "https://my.website.com/finish",
"billing": {}
}
],
"mode": "live",
"nextAction": {
"type": "ussd",
"message": "<string>",
"data": {
"url": "<string>",
"urls": "<string>",
"method": "post",
"headers": {},
"data": {}
}
},
"lastPaymentFailure": {
"code": "internal_error",
"message": "<string>",
"params": [
"<string>"
]
},
"overrideBusinessName": "MyBusiness"
}
Headers
Your api key. To create a key, please get into our dashboard. If you don't have access to it, please reach the Support team.
Your merchant ID. This information is available in our dashboard. If you don't have access to it, please reach the Support team.
Allow you to choose between the sandbox mode to perform some tests or the live mode for real world transactions.
Available options:
live
, sandbox
Body
application/json
Response
201
application/json
The response is of type object
.
{
"id": "pi_z1urYtVFgEebtcj8fxp4v",
"merchantId": "<string>",
"createdAt": "2020-10-15T12:09:49.355Z",
"updatedAt": "2020-10-15T12:16:26.128Z",
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtZXJjaGFudElkIjoiMTYiLCJtb2RlIjoic2FuZGJveCIsInBheW1lbnRJZCI6InBpX3oxdXJZdFZGZ0VlYnRjajhmeHA0diIsImlhdCI6MTYwMjc1OTE4M30.OZ0fDnMVWvcT-gRthyBD58PFC20gabGKt1UPRe4aNi4",
"purchaseReference": "ref_2020_11_10_001",
"customerReference": "cust_01924059",
"status": "successful",
"amount": 100,
"currency": "XOF",
"payments": [
{
"id": "pay_QW2d6JnqiatcH8KhK0mD1",
"intentId": "pi_z1urYtVFgEebtcj8fxp4v",
"createdAt": "2020-10-15T12:09:49.355Z",
"updatedAt": "2020-10-15T12:16:26.128Z",
"status": "successful",
"amount": 100,
"currency": "XOF",
"method": "credit_card",
"country": "CI",
"failure": {
"code": "internal_error",
"message": "<string>",
"params": [
"<string>"
]
},
"fees": [
{
"id": "lAe5HnFpvOjwdT9vSIgPA",
"rate": 123,
"rateType": "percent",
"amount": 5,
"currency": "XOF",
"label": "<string>",
"taxes": [
"<string>"
]
}
],
"nextAction": {
"type": "ussd",
"message": "<string>",
"data": {
"url": "<string>",
"urls": "<string>",
"method": "post",
"headers": {},
"data": {}
}
},
"providerReference": "<string>",
"gatewayId": "<string>",
"number": "<string>",
"onSuccessRedirectionUrl": "https://my.website.com/cancel",
"onFailedRedirectionUrl": "https://my.website.com/finish",
"billing": {}
}
],
"mode": "live",
"nextAction": {
"type": "ussd",
"message": "<string>",
"data": {
"url": "<string>",
"urls": "<string>",
"method": "post",
"headers": {},
"data": {}
}
},
"lastPaymentFailure": {
"code": "internal_error",
"message": "<string>",
"params": [
"<string>"
]
},
"overrideBusinessName": "MyBusiness"
}