Skip to main content

​
Endpoint

POST /api/sandbox/v1/allocations/new

​
Base URL

https://api.kiotapay.co

​
Request Headers

KeyValueRequiredDescription
Content-Typeapplication/json✅Specifies that the request body is in JSON format.
AuthorizationBearer <your-token>✅API authentication token. Replace <your-token> with a valid JWT.

​
Request Body

{
    "fromOrganisationId":"4d6e1ea9-5ab8-496a-978f-7e9b2bce80c4",
    "toOrganisationId":"b2f0a5ff-e9d8-4347-b46d-6eee8d195617",
    "amount":20
}
Explanation
FieldTypeDescription
fromOrganisationStringThe Organisation Id where the deduction will happen
toOrganisationIdstringThe sOrganisation id where the funds will be allocated.
amountnumberThe amount of money to be allocated
Sample Response Body 
{
    "status": 201,
    "message": "Created Successfully",
    "data": {
        "status": "SUCCESS",
        "requestId": "ade82d5a-4ab0-4d96-b855-b7f933336f97",
        "amount": 20.0
    }
}