Senders & Recipients

Who money comes from, and who it goes to

A sender funds an order. A recipient gets paid. What each one needs depends on their country and currency — so ask first, then create.

1. Ask what's needed

curl -X POST 'https://sandbox-api.transfi.com/v3/senders/mandatory-fields' \
  -H 'Authorization: Basic YOUR_BASE64_CREDENTIALS' \
  -H 'mid: YOUR_MID' \
  -H 'Content-Type: application/json' \
  -d '{ "country": "GB", "type": "individual", "currencyType": "fiat" }'

Build your form from the inputs in the response.

2. Create them

curl -X POST 'https://sandbox-api.transfi.com/v3/senders/individual' \
  -H 'Authorization: Basic YOUR_BASE64_CREDENTIALS' \
  -H 'mid: YOUR_MID' \
  -H 'Content-Type: application/json' \
  -d '{ ...the fields from step 1... }'

→ Senders: Mandatory Fields · Individual · Business
→ Recipients: Mandatory Fields · Individual · Business

🛑
Never hard-code the fields. They differ by country and they change. Fetch them every time.

📘
Creating the same person twice returns the existing userId. Safe to retry.

📘
One person, both roles. A recipient who later needs to send is promoted, not recreated — Change User Role. Check roles with Get User Account Type.

Updated 30 minutes ago

Did this page help you?