Cash In - OLIVE Payment Platform

BODY='{"phone_number":"0771234567","amount":50000,"reference":"PARTNER-TXN-123"}' TIMESTAMP='2026-03-10T12:00:00Z' SIGNATURE=$(printf 'POST\n/api/v1/partner/cashin\n%s\n%s' "$TIMESTAMP" "$BODY" | openssl dgst -sha256 -hmac "$OLIVE_HMAC_SECRET" -hex | sed 's/^.* //') curl -X POST "https://demo.api.vultlocal.com/api/v1/partner/cashin" \ -H "X-API-Key-ID: $OLIVE_API_KEY_ID" \ -H "X-Partner-ID: $OLIVE_PARTNER_ID" \ -H "X-Timestamp: $TIMESTAMP" \ -H "X-Signature: $SIGNATURE" \ -H "Content-Type: application/json" \ -d "$BODY"

Authentication

string

required

API key ID issued for the partner integration

string

required

Partner identifier such as VULT

string

required

RFC3339 timestamp used when generating the signature

string

required

Hex-encoded HMAC-SHA256 of METHOD + "\n" + PATH + "\n" + TIMESTAMP + "\n" + BODY

Example

BODY='{"phone_number":"0771234567","amount":50000,"reference":"PARTNER-TXN-123"}'
TIMESTAMP='2026-03-10T12:00:00Z'
SIGNATURE=$(printf 'POST\n/api/v1/partner/cashin\n%s\n%s' "$TIMESTAMP" "$BODY" | openssl dgst -sha256 -hmac "$OLIVE_HMAC_SECRET" -hex | sed 's/^.* //')

curl -X POST "https://demo.api.vultlocal.com/api/v1/partner/cashin" \
  -H "X-API-Key-ID: $OLIVE_API_KEY_ID" \
  -H "X-Partner-ID: $OLIVE_PARTNER_ID" \
  -H "X-Timestamp: $TIMESTAMP" \
  -H "X-Signature: $SIGNATURE" \
  -H "Content-Type: application/json" \
  -d "$BODY"

{ "success": true, "transaction_id": "txn_abc123", "message": "Cash-in successful", "data": { "subscriber_id": "sub_xyz789", "name": "John Doe", "amount": 50000, "new_balance": 75000, "currency": "SLE", "reference": "TXN-123456" } }

Errors

Status	Description
400	Invalid request body
401	Missing or invalid HMAC headers/signature
404	Subscriber not found
500	Transaction failed

Authorizations

Authorization

string

header

required

API Key for third-party integrations (WhatsApp, Smart PAY, VULT). Format: 'Bearer olive_live_xxxxxxxxxxxxx'

Headers

X-API-Key-ID

string

required

X-Partner-ID

string

required

X-Timestamp

string

required

X-Signature

string

required

Body

application/json

amount

integer

required

reference

string

required

phone_number

string

card_serial

string

Response

200 - application/json

Success

The response is of type object.

​Authentication

​Request Body

​Example

​Response

​Transaction Flow

​Errors

Authorizations

Headers

Body

Response

Authentication

Request Body

Example

Response

Transaction Flow

Errors