Create Individual Sender

post

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

Creates an individual sender and returns the userId you use for KYC and for every order they pay for. Call POST /v3/senders/mandatory-fields with type: individual 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 sender. Must match the geo you sent to POST /v3/senders/mandatory-fields.

currencyType

enum

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

Allowed:

firstName

string

Dynamic field — send it only when inputs from POST /v3/senders/mandatory-fields names it for your corridor.

lastName

string

Dynamic field — send it only when inputs from POST /v3/senders/mandatory-fields names it for your corridor.

string

Email address of the sender. 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 +.

dob

string

Date of birth, in the format the field specification's validationMessage states — DD-MM-YYYY for the corridor shown here.

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