Recipients

Create Business Recipient

Changed on

Creates a business recipient — a legal entity that receives payouts — and returns the userId you reference when paying it. Build this body from the inputs returned by POST /v3/recipients/mandatory-fields with type: organization. A recipient matching the details you sent returns the existing userId with code: USER_ALREADY_EXISTS.

post/v3/recipients/business

Request

Headers

MIDstring required

Merchant or sub-merchant MID

Request body

countrystring

Two Digit Country Code

currencyType'fiat' | 'crypto'

Type of currency being used to payout to recipient

businessNamestring

Registered Business Name of the Recipient

Example request

{
  "country": "ID",
  "currencyType": "fiat",
  "businessName": "Random Business Name",
  "accountIdentifier": {
    "type": "mobile_wallet",
    "value": "+912121212121"
  }
}

Response

OK

statusstring required

Changes

    • warning

      removed the request property

    • info

      the request property became optional

    • info

      the request property became optional

    • info

      the request property became optional

    • info

      added the non-success response with the status

    • info

      added the optional property / to the response with the status