POST
/
v1
/
terminals
/
payment-request
/
{terminalId}
Send payment request to terminal
curl --request POST \
  --url https://api.nomba.com/v1/terminals/payment-request/{terminalId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "merchantTxRef": "55555555",
  "amount": "1000",
  "currency": "NGN"
}'
{
  "code": "00",
  "description": "Success",
  "data": {
    "paymentId": "890022ce-bae0-45c1-9b9d-ee7872e6ca27",
    "status": "pending",
    "amount": 1000,
    "currency": "NGN",
    "createdAt": "2023-08-30T14:56:59.000Z"
  }
}

Authorizations

Authorization
string
header
required

Nomba authenticates API calls with OAuth2 HTTP bearer tokens. There are two methods of authentication; Client-Credentials method and PKCE (Proof Key for Code Exchange) method. In each of the methods, You will get an ACCESS_TOKEN. You need to use an "Authorization" HTTP header to provide your ACCESS_TOKEN. For example: Authorization: {ACCESS_TOKEN}.

Body

application/json

The request payload required to send payment request to a nomba terminal

Represents a request to initiate a payment on a physical payment terminal.

Response

200
application/json

OK - your request was successful.

The response is of type object.