Create Payment Instruction Request

Testing Env

https://api.uat.sokin.com

POST

/instruction-requests/payment

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢202Accepted

application/json

Successful Response

Body

🟠422Unprocessable Entity

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.uat.sokin.com/instruction-requests/payment' \
--header 'x-api-version: 2025-12-01' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "corporate_currency_account": "CCA-Corp-18970222-GBP-1",
    "idempotency_key": "ace0f2fd-2e47-4504-b16c-f2337d366f30",
    "reseller_fee": "0.00",
    "beneficiary_reference": "7d845fc1-0ca8-439c-9612-84abc5345371",
    "sender_reference": "Invoice 001",
    "purpose_of_payment": "Commercial",
    "amount": 3319.87,
    "amount_is_fees_inclusive": false
}'

Response Example

202 - Example 1

{
    "external_reference": "IR-Payment-8af41960-04c9-48bc-a683-6b3364f58f47"
}

Modified at 2025-12-02 08:52:09

Get Instruction Request By Reference

Create Fx Instruction Request