Create Reserved Account
Create a dedicated virtual account for a customer.
Endpoint
POST https://mainapi.cashonrails.com/api/v1/reserved_virtual_account
Request Headers
| Header | Type | Description |
|---|---|---|
| Content-Type | string | application/json |
| Authorization | string | Bearer token with your secret key |
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| customer_code | string | Yes | Customer’s unique identifier (Get Customer Details) |
| provider | string | Yes | Virtual account provider e.g, netbank (Get Providers) |
| id | string | Yes | Unique identifier for the reserved account |
How to get the customer_code
-
Create a New Customer: Make a
POSTrequest to Create Customer endpoint. The response will contain the customer_code. -
Find Existing Customer:
- Use Get Customer to find by ID
- Use List Customers to search all customers
Sample Request
curl --location 'https://mainapi.cashonrails.com/api/v1/reserved_virtual_account' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_KEY' \
--data '{
"customer_code": "CUS_2qag1olxkkom7kl",
"provider": "netbank",
"id": "unique_identifier"
}'