Create Fx Payment Instruction Request

Testing Env

https://api.uat.sokin.com

POST

/instruction-requests/fx-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/fx-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": "0d048531-657e-4cac-8950-d1dd41a902f8",
    "reseller_fee": "0.00",
    "beneficiary_reference": "d0b5d035-2d96-45c5-abee-29c199a92813",
    "sender_reference": "Payment for Invoice",
    "purpose_of_payment": "Commercial",
    "quote_id": "0173ddb1-b02b-4941-9342-ebad4d6371a3"
}'

Response Example

202 - Example 1

{
    "external_reference": "IR-Fxpayment-f73cd251-3509-468f-8e07-9f87fbd1ca2d"
}

Modified at 2025-12-05 12:11:38

Create Fx Instruction Request

Create Unfunded Payment Instruction Request