Process in-app payment - OLIVE Payment Platform

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"

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.