Skip to main content
POST
/
payment
Process in-app payment
curl --request POST \
  --url https://olive-gateway-a6ba.onrender.com/api/v1/payment \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": "150.00",
  "card_serial": "CARD0001",
  "currency": "SLE",
  "merchant_id": "MERCHANT001",
  "pin": "1234",
  "processor_id": "proc-uuid-123",
  "terminal_id": "TERM001",
  "transaction_ref": "POS-TXN-123"
}
'
{}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

In-app payment details

​
amount
string
required

Accepts decimal format like "150.00" or "150"

Example:

"150.00"

​
card_serial
string
required

Supports any alphanumeric: CARD0001, 48290173K, etc.

Example:

"CARD0001"

​
currency
string
required
Example:

"SLE"

​
merchant_id
string
required
Example:

"MERCHANT001"

​
pin
string
required
Example:

"1234"

​
processor_id
string
required

Processor account that receives the funds

Example:

"proc-uuid-123"

​
terminal_id
string
required
Example:

"TERM001"

​
transaction_ref
string
required
Example:

"POS-TXN-123"

​
merchant_name
string

Display name for receipts

Example:

"ABC Store"

​
metadata
object

Response

Payment approved

The response is of type object.