Role Change

Get Role Change Mandatory fields

Changed on

Step 1 of the role change flow. Returns the additional data TransFi needs before an existing user can also act in targetRole - a recipient promoted to a sender, or a sender promoted to a recipient. Send the fields it names to POST /v3/role-change/individual or POST /v3/role-change/business.

post/v3/role-change/mandatory-fields

Request

Headers

MIDstring required

Merchant or sub-merchant MID

Request body

targetRole'recipient' | 'sender' required

Role you want the existing user to additionally hold.

userIdstring required

TransFi user id of the existing user. Must start with UX-.

currencyType'crypto' | 'fiat'

Currency rail the user will transact on in the new role. Defaults to fiat. Send the same value in step 2.

Example request

{
  "targetRole": "sender",
  "userId": "UX-260326115551596837",
  "currencyType": "fiat"
}

Response

OK

statusstring required
traceIdstring

Changes