TRtransfi
Senders

Create Business Sender

Changed on

Creates a business sender — a legal entity that funds orders — and returns the userId you use for KYB and for every order it pays for. Call POST /v3/senders/mandatory-fields with type: organization first and build this body from the inputs it returns; the properties below are one corridor's fields, not a fixed list. A sender matching the details you sent returns 200 with the existing userId and code: USER_ALREADY_EXISTS.

post/v3/senders/business

Request

Headers

MIDstring required

Merchant or sub-merchant MID

Request body

countrystring

Two digit country code of the business sender. Must match the geo you sent to POST /v3/senders/mandatory-fields.

currencyType'fiat' | 'crypto'

Currency type the business will fund with. Must match the currencyType you sent to POST /v3/senders/mandatory-fields.

businessNamestring

Registered business name of the sender. Dynamic field — send it only when inputs from POST /v3/senders/mandatory-fields with type: organization names it for your corridor.

emailstring

Email address of the business. When supplied it is verified and an email verification message may be sent, so send a syntactically valid address.

phonestring

National phone number without the country calling code. Send it together with phoneCode when a mutually_required rule pairs them.

phoneCodestring

International dialling code for phone — digits with an optional leading +, 1-4 characters including the +.

Example request

{
  "country": "ID",
  "currencyType": "fiat",
  "businessName": "Random Business Name",
  "email": "finance@randombusiness.example",
  "phone": "81234567890",
  "phoneCode": "+62"
}

Response

OK

statusstring required
traceIdstring

Changes