Create

Developing

POST

/api/v1/partner/payouts/remittances/recipients/businesses

This endpoint only supports creating recipient business for specific countries. Currently, the list of supported countries for business recipients is:

No	Recipient Country	Country Code	Currency Code
1	United States of America	USA	USD
2	Lithuania	LTU	EUR
3	Germany	DEU	EUR
4	China	CHN	CNY
4	United Kingdom	GBR	GBP

If you send a request with the country parameter outside of the list above, the system will reject the request and return an appropriate error status.

📌

Recipient data below represents a sample payload for the USA. For payloads of other recipient countries, please refer to the this endpoint:/api/v1/partner/payouts/remittances/recipients/businesses/forms/{recipient_country}, and ensure that you follow the validation rules provided there.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Body

🟠400Invalid Data

🟠401Unauthorized

🟠404Resource not found

🟠404Data Not Found

🟠401Token Expired

🟠400Validation Error

🟠409Duplicate Record

🔴500Internal Server Error

🟠400Invalid Data

🟠400Validation Error

🟠401Invalid Account

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/api/v1/partner/payouts/remittances/recipients/businesses' \
--header 'Authorization: {{token}}' \
--header 'ClientSecret: {{ClientSecret}}' \
--header 'Signature: {{signature}}' \
--header 'Date: {{dateRequest}}' \
--header '{{userKey}}: {{userKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "recipientData": {
        "recipientCountryCode": "USA",
        "recipientCurrencyCode": "USD",
        "recipientDetails": {
            "businessInformation": {
                "businessNumber": "BIZ-20250910",
                "businessName": "Pacific Horizon Solutions Inc.",
                "preferredName": "Pacific Horizon",
                "emailAddress": "contact+pacifichorizon@gmail.com",
                "phonePrefix": "1",
                "phoneNumber": "4155550134",
                "foundationDate": "2005-07-15",
                "numberOfEmployee": "250",
                "taxIdNumber": "AKJD012910212"
            },
            "userInformation": {
                "firstName": "Michael",
                "middleName": "Andrew",
                "lastName": "Johnson",
                "preferredName": "Mike",
                "fullName":"Michael Andrew Johnson",
                "emailAddress": "dummyuser+mikejohnson@gmail.com",
                "phonePrefix": "1",
                "phoneNumber": "2025550198",
                "pobCountryCode": "USA",
                "pob": "New York",
                "dob": "1994-03-18"
            },
            "bankDetails": {
                "accountNumber": "09102123",
                "accountCode": "091234562",
                "accountName": "Pacific Horizon Solutions",
                "accountTypeId": "5d7e4f2f-c8ea-4a2f-b83d-cb1d162a4db0",
                "bankId": "RMT1-8c0608f7ce7d4de99f6d9efe77841dea",
                "bankName": "ABANCA USA",
                "bankBranchId": "",
                "bankBranchName": ""
            },
            "addressDetails":{
                "countryCode": "USA",
                "state": "California",
                "city": "Los Angeles",
                "district": "Downtown",
                "subdistrict": "Arts District",
                "zipcode": "90012",
                "address": "1234 Sunset Boulevard"
            },
            "identificationDetails": {
                "typeId": "93a603a6-6446-44f1-8971-6c7316aadf0f",
                "idNumber": "1234567890123456",
                "issueCountryCode": "USA",
                "issueDate": "2020-12-19",
                "expiredDate": "2028-01-12",
                "issueState": "California",
                "issueCity": "San Francisco",
                "issuePlace": "450 Golden Gate Ave",
                "issueAuthority": "California Department of Motor Vehicles"
            },
            "additionalData": {
                "purposeOfPaymentId": "0a5ac571-f746-4afb-a528-9a3a5baffe64",
                "recipientRelationshipId": "ba3795bd-27c4-406c-9445-9f8bd6c51f88"
            }
        }
    }
}'

Response Example

200 - Success

{
    "status": 200,
    "serviceStatus": "2001701",
    "titleCode": "success",
    "title": "Success",
    "detail": "Processed successfully",
    "responseTime": "2025-09-12T02:20:31.974+00:00",
    "data": {
        "id": "6a653804-dee0-4f8f-8a07-b92bd852cf50",
        "recipientCountryCode": "USA",
        "recipientCountry": "United States",
        "recipientCurrencyCode": "USD",
        "recipientType": "BUSINESS",
        "status": "PENDING",
        "isActive": false,
        "isNeedUpdate": false,
        "ownershipStatus": "ROOT",
        "ownershipId": "93cffe3b-effc-494a-a1f7-3ed04c7f75ce",
        "lastInactiveAt": "2025-09-12T02:20:30Z",
        "inactiveReason": "External Status: PENDING",
        "createdAt": "2025-09-12T02:20:30Z",
        "createdBy": "(API_PARTNER) Lingkar Sembilan Titian Media",
        "recipientDetails": {
            "bankDetails": {
                "accountNumber": "09102123",
                "accountCode": "091234562",
                "accountName": "Pacific Horizon Solutions",
                "accountTypeId": "5d7e4f2f-c8ea-4a2f-b83d-cb1d162a4db0",
                "accountTypeName": "Savings Account",
                "bankId": "RMT1-8c0608f7ce7d4de99f6d9efe77841dea",
                "bankName": "ABANCA USA"
            },
            "identificationDetails": {
                "typeId": "93a603a6-6446-44f1-8971-6c7316aadf0f",
                "typeName": "Voter's photo ID card",
                "idNumber": "1234567890123456",
                "issueCountryCode": "USA",
                "issueCountry": "United States",
                "issueDate": "2020-12-19",
                "expiredDate": "2028-01-12",
                "issueState": "California",
                "issueCity": "San Francisco",
                "issuePlace": "450 Golden Gate Ave",
                "issueAuthority": "California Department of Motor Vehicles"
            },
            "userInformation": {
                "firstName": "Michael",
                "middleName": "Andrew",
                "lastName": "Johnson",
                "fullName": "Michael Andrew Johnson",
                "preferredName": "Mike",
                "emailAddress": "dummyuser+mikejohnson@gmail.com",
                "phonePrefix": "1",
                "phoneNumber": "2025550198",
                "genderName": "BYPASS",
                "pobCountryCode": "USA",
                "pobCountry": "United States",
                "pob": "New York",
                "dob": "1994-03-18",
                "nationalityName": "BYPASS",
                "occupationName": "BYPASS",
                "sourceOfIncomeName": "BYPASS"
            },
            "businessInformation": {
                "businessNumber": "BIZ-20250910",
                "businessName": "Pacific Horizon Solutions Inc.",
                "preferredName": "Pacific Horizon",
                "emailAddress": "contact+pacifichorizon@gmail.com",
                "phonePrefix": "1",
                "phoneNumber": "4155550134",
                "foundationDate": "2005-07-15",
                "foundationYear": "2005",
                "numberOfEmployee": "250",
                "nationalityName": "BYPASS"
            },
            "addressDetails": {
                "countryCode": "USA",
                "state": "California",
                "city": "Los Angeles",
                "district": "Downtown",
                "subdistrict": "Arts District",
                "zipcode": "90012",
                "address": "1234 Sunset Boulevard"
            },
            "additionalData": {
                "purposeOfPaymentId": "0a5ac571-f746-4afb-a528-9a3a5baffe64",
                "purposeOfPaymentName": "Household Maintenance",
                "recipientRelationshipId": "ba3795bd-27c4-406c-9445-9f8bd6c51f88",
                "recipientRelationshipName": "Daughter"
            }
        }
    }
}

Modified at 2025-09-18 10:21:19

Recipient Form

Update Recipient