POST

Create Standing Order

Set up a recurring automated transfer between two accounts.

POST/v2/standing-orders/create

Use this endpoint to automate recurring payments, such as loan repayments, subscriptions, or savings contributions. You can define the frequency and exact duration of the automated deductions.

Headers

HeaderRequiredDescription
AuthorizationYESBearer token containing your secret API key.
Content-TypeYESMust be set to application/json.

Body Parameters

ParameterTypeRequiredDescription
source_accountstringYESThe 10-digit account number to be debited.
destination_accountstringYESThe 10-digit account number to be credited.
amountnumberYESThe amount to be transferred on each execution.
frequencystringYESHow often it should execute. Options: DAILY, WEEKLY, MONTHLY.
start_datestringYESThe ISO-8601 date when the first deduction should happen.
end_datestringNOThe ISO-8601 date when the order expires. If omitted, it runs indefinitely.

Example Request

cURL
curl -X POST "https://sandbox.hexcore.io/v2/standing-orders/create" \-H "Authorization: Bearer sk_test_your_secret_key" \-H "Content-Type: application/json" \-d '{ "source_account": "1234567890", "destination_account": "0987654321", "amount": 50000, "frequency": "MONTHLY", "start_date": "2026-06-01T00:00:00Z", "end_date": "2027-05-01T00:00:00Z" }'

Example Response

JSON (201 Created)
{"status": true,"message": "Standing order created successfully","data": {"order_id": "so_x9y8z7w6v5","status": "ACTIVE","next_execution_date": "2026-06-01T00:00:00Z","created_at": "2026-05-02T10:00:00Z"} }