​

POST /v1/terminals/payment-request/{terminalId}

​

Path parameters

​

Request body

​

Response body

curl --request POST \
  --url https://api.nomba.com/v1/terminals/payment-request/<terminalId> \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'accountId: <accountId>' \
  --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"
  }
}

​

How It Works

​

Flow Description

1. Customer Orders an Item The customer initiates a purchase through your client application.
2. Client Sends Order to Server Your frontend sends the order details (including orderId, amount, and currency) to your backend.
3. Server Sends Payment Request to Nomba Your backend uses the POST /v1/terminals/payment-request/{terminalId} endpoint to trigger a payment on the specific terminal.
4. Nomba Pushes Payment to Terminal The terminal receives a payment prompt and displays the amount to the customer.
5. Customer Makes Payment on Terminal The customer completes the payment using a supported payment method.
6. Nomba Sends Webhook to Your Server Upon successful payment, Nomba sends a webhook to your server with the payment confirmation and metadata.

​

Webhook Notification