Create Business Sender

post

https://sandbox-api.transfi.com/v3/senders/business

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.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

country

string

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

currencyType

enum

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

Allowed:

businessName

string

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.

string

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

phone

string

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

phoneCode

string

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

Headers

MID

string

required

Merchant or sub-merchant MID

Responses

Language

Credentials

Basic

base64

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200OK

400Bad Request

409Conflict