TouchPay ORS Cashier API

Base URL

https://ors-api.touchpay.so/api/v1

Authentication

All requests must include the following HTTP headers:

Content-Type: application/json
X-API-KEY: your_api_key
X-API-SECRET: your_api_secret

Endpoints

GET /cashier

Retrieve cashier account information.

Response

{
  "cashier_name": "John Doe",
  "agent_name": "MMT Global",
  "available_limit": 125.50
}
POST /remittances/preview

Preview a remittance before submitting.

Request

{
  "receiver_phone": "0615445566",
  "amount": 10,
  "country_code": "252"
}

Response

{
  "success": true,
  "country_code": "252"
  "receiver_phone": "0615445566",
  "receiver_name": "Ahmed Ali",
  "current_balance": 125.50,
  "send_amount": 10,
  "rate_percent": "3%",
  "commission_amount": 0.30,
  "total_deduction": 10.30,
  "balance_after_send": 115.20
}
POST /remittances

Submit a remittance transaction.

Request

{
  "receiver_phone": "0615445566",
  "amount": 10,
  "country_code": "252"
}

Response

{
    "success": true,
    "code": "REMITTANCE_CREATED",
    "message": "Remittance submitted successfully",
    "data": {
        "transaction_id": 875768
    }
}
GET /remittances

Retrieve remittance history.

Query Parameters (Optional)

Parameter Description
transaction_id Transaction ID
status Completed | Underprocess
from YYYY-MM-DD
to YYYY-MM-DD

Response

{
  "count": 1,
  "data": [
    {
      "transaction_id": 206,
      "receiver_phone": "0613504684",
      "receiver_country": "Somalia",
      "amount": 2,
      "commission": 0.02,
      "total_deduction": 2.02,
      "status": "Completed",
      "created_at": "2025-12-25 16:59:58"
    }
  ]
}