Create Beneficiary

Method and URL

POST [BASE_URL]/xb/beneficiary

Request Params

Request Body

{
    "name": "Merci Beacou Supa",
    "countryCode": "US",
    "state": "New York",
    "city": "New York City",
    "address": "Jl Amerika",
    "postcode": "12345",
    "accountType": "Individual",
    "accountNumber": "35628342",
    "identificationType": "Passport",
    "identificationNumber": "X123456",
    "bankName": "Bank of America"
    // "bankCode": "123", → only for beneficiary country Korea
    // "contactCountryCode": "+81", → only for beneficiary country Korea
    // "contactNumber": "123134123", → only for beneficiary country Korea
    // "email": "[e-mail]", → only for beneficiary country Korea
    // “payoutMethod”: “WALLET” → only for sending to Alipay (BANK/WALLET/CASH)
}

Response

Response Body

{
    "code": "00",
    "message": "Success",
    "data": {
        "uuid": "62b39dd6-85dc-4c33-b9d9-edc992251bf3",
        "name": "Merci Beacou Supa",
        "accountType": "Individual",
        "address": "Jl Amerika",
        "city": "New York City",
        "postcode": "12345",
        "state": "New York",
        "countryCode": "US",
        "identificationType": "Passport",
        "identificationNumber": "X123456",
        "accountNumber": "35628342",
        "bankName": "Bank of America",
        "bankCode": "",
        "contactCountryCode": "",
        "contactNumber": "",
        "email": "",
        "createdAt": "2024-11-07T02:43:52Z"
    }
}