Use the Update Account Holder endpoint to:
- Update your Account Holder information. This step may be needed when the your information and document submission is insufficient or invalid (e.g invalid website, blurry selfie, invalid ID, etc.).
- Activate a payment channel Capability on an Account Holder object associated with a sub-account
You need to provide an URL to receive webhooks. Please specify your URL in Webhook Settings in the Xendit Dashboard.
You will need the Account Holder
WriteAPI key permission to perform this request.
{
"website_url": "valid-marketplace.brand.com"
}{
"kyc_documents": {
"country": "PH",
"type": "LATEST_GIS_DOCUMENT",
"file_id": "63f8719642f5856dc9feje7"
}
}{
"capabilities": [
{
"type": "MONEY_IN",
"channel_code": "PH_CARDS"
},
{
"type": "MONEY_IN",
"channel_code": "GCASH"
}
]
}An object containing the business detail of the Account Holder
The entity type of the business
Legal name of the business. This must match the documentation submitted.
Trading or brand name of the business. This will be the name that appears to endpayer on payment page.
Description of the business. Please specify what business model or goods and services that the business provide. Max 1000 characters.
One of our accepted Industry Category Codes depending on your entity type and country of operation.
Refer to the list of accepted industry category codes here
Business registration date in YYYY-MM-DD
The country (based on ISO 3166-1 Alpha-2) of incorporation for a business, or the country of residence for an individual.
An object containing the individual details of the Account Holder. This could be the details of the business owner, director etc. You may submit multiple PICs (Person in Charge) for your business in this object.
A minimum 1 Incorporator and 1 PIC is required when they need to activate Cards capabilities. Whereas 1 PIC is required when they need to activate Gcash capabilities. Please see more details here
This role specifies the role of the PIC or Incorporator. E.g. Owner, Director, Administrator.
First and middle name (if any) of the account holder
Surname or family name of the account holder
The contact number of the Account Holder in E.164 format. This may also be a landline.
The email address of the account holder
Country code for customer's nationality (ISO 3166-2 Country Code)
City or other relevant location of the account holder's birth place
Date of birth of the customer in YYYY-MM-DD
The gender of the account holder
Tax Identification Number of the account holder. This parameter is required when they need to activate Cards capabilities with USD or recurring capabilities.
Please see more details here
An address object.
The country (based on ISO 3166-1 Alpha-2) of incorporation for a business, or the country of residence for an individual.
City, village or town
Province, state or region
Line 1 of street address e.g street number and name
Line 2 of street address e.g building name or apartment number
District
Sub-district
Zip or postal code
An address object.
The country (based on ISO 3166-1 Alpha-2) of incorporation for a business, or the country of residence for an individual.
City, village or town
Province, state or region
Line 1 of street address e.g street number and name
Line 2 of street address e.g building name or apartment number
District
Sub-district
Zip or postal code
A KYC document file for Account Holder verification
The country (based on ISO 3166-1 Alpha-2) of incorporation for a business, or the country of residence for an individual.
The type of the legal or KYC requirements document
Refer to the list of Required KYC Documents for all countries here
Expiry date of the document if relevant. Format YYYY-MM-DD
The file ID returned by the Upload API
A valid website associated with the business
A valid phone number associated with the business
A valid email address associated with the object
{
"id": "4376b7b0-1c44-46be-8640-828f79cdc8be",
"business_detail": {
"type": "CORPORATION",
"legal_name": "My Store Inc.",
"trading_name": "John's Store",
"description": "description here",
"industry_category": "ELECTRONICS_AND_ACCESSORIES",
"date_of_registration": "2023-02-02T00:00:00.000Z",
"country_of_operation": "PH"
},
"individual_details": [
{
"given_names": "John",
"surname": "Doe",
"phone_number": "+63021234567",
"email": "test@xendit.co",
"nationality": "PH",
"place_of_birth": "PH",
"date_of_birth": "2000-02-02",
"gender": "MALE",
"type": "PIC",
"role": "owner"
}
],
"address": {
"country": "PH",
"city": "Caloocan",
"street_line1": "9th St",
"street_line2": "Building 101",
"district": "1st district",
"province_state": "Metro Manila",
"postal_code": "1400"
},
"kyc_documents": [
{
"type": "SEC_CERTIFICATE_REGISTRATION_DOCUMENT",
"country": "PH",
"file_id": "63f8719642f5856dcb142bd2"
},
{
"type": "ARTICLES_OF_INCORPORATION_DOCUMENT",
"country": "PH",
"file_id": "63f8719642f5856dcb142bd2"
},
{
"type": "NOTARIZED_SECRETARY_CERTIFICATE_DOCUMENT",
"country": "PH",
"file_id": "63f8719642f5856dcb142bd2"
},
{
"type": "LATEST_GIS_DOCUMENT",
"country": "PH",
"file_id": "63f8719642f5856dcb142bd2"
},
{
"type": "ACR_OR_IMMIGRANT_COR_DOCUMENT",
"country": "PH",
"file_id": "63f8719642f5856dcb142bd2"
},
{
"type": "SERVICE_AGREEMENT_DOCUMENT",
"country": "PH",
"file_id": "63f8719642f5856dcb142bd2"
}
],
"website_url": "https://xendit.co",
"phone_number": "+6381234567",
"email": "test@xendit.co",
"kyc": {
"status": "PASSED",
"requested_at": "2021-01-01T10:00:00Z",
"verified_at": "2021-01-02T10:00:00Z",
"kyc_passed_at": "2021-01-03T10:00:00Z"
},
"capabilities": [
{
"type": "MONEY_IN",
"channel_code": "GCASH",
"requested_at": "2021-01-01T10:00:00Z",
"verified_at": "2021-01-02T10:00:00Z",
"activated_at": "2021-01-03T10:00:00Z",
"status": "VERIFICATION_IN_PROGRESS"
}
]
}An object containing the business detail of the Account Holder
The entity type of the business
Legal name of the business. This must match the documentation submitted.
Trading or brand name of the business. This will be the name that appears to endpayer on payment page.
Description of the business. Please specify what business model or goods and services that the business provide. Max 1000 characters.
One of our accepted Industry Category Codes depending on your entity type and country of operation.
Refer to the list of accepted industry category codes here
Business registration date in YYYY-MM-DD
The country (based on ISO 3166-1 Alpha-2) of incorporation for a business, or the country of residence for an individual.
An object containing the individual details of the Account Holder. This could be the details of the business owner, director etc. You may submit multiple PICs (Person in Charge) for your business in this object.
A minimum 1 Incorporator and 1 PIC is required when they need to activate Cards capabilities. Whereas 1 PIC is required when they need to activate Gcash capabilities. Please see more details here
This role specifies the role of the PIC or Incorporator. E.g. Owner, Director, Administrator.
First and middle name (if any) of the account holder
Surname or family name of the account holder
The contact number of the Account Holder in E.164 format. This may also be a landline.
The email address of the account holder
Country code for customer's nationality (ISO 3166-2 Country Code)
City or other relevant location of the account holder's birth place
Date of birth of the customer in YYYY-MM-DD
The gender of the account holder
Tax Identification Number of the account holder. This parameter is required when they need to activate Cards capabilities with USD or recurring capabilities.
Please see more details here
An address object.
The country (based on ISO 3166-1 Alpha-2) of incorporation for a business, or the country of residence for an individual.
City, village or town
Province, state or region
Line 1 of street address e.g street number and name
Line 2 of street address e.g building name or apartment number
District
Sub-district
Zip or postal code
An address object.
The country (based on ISO 3166-1 Alpha-2) of incorporation for a business, or the country of residence for an individual.
City, village or town
Province, state or region
Line 1 of street address e.g street number and name
Line 2 of street address e.g building name or apartment number
District
Sub-district
Zip or postal code
A KYC document file for Account Holder verification
The country (based on ISO 3166-1 Alpha-2) of incorporation for a business, or the country of residence for an individual.
The type of the legal or KYC requirements document
Refer to the list of Required KYC Documents for all countries here
Expiry date of the document if relevant. Format YYYY-MM-DD
The file ID returned by the Upload API
A valid website associated with the business
A valid phone number associated with the business
A valid email address associated with the object
An object containing the details of the Account Holder capabilities activation process
Timestamp of when the object was updated
Timestamp of when the object was updated
Timestamp of when the object was updated
Timestamp of when the object was updated
Timestamp of when the object was updated
Timestamp of when the object was updated
{
"error_code": "INSUFFICIENT_ACCOUNT_HOLDER_DATA",
"message": "The information in the Account Holder object is not sufficient to request activation for this payment channel. Please update the fields with the correct information.",
"errors": [
"Detailed description here"
]
}Inputs are failing validation. The errors field contains details about which fields are violating validation.
{
"error_code": "KYC_VERIFICATION_IN_PROGRESS",
"message": "Account Holder cannot be updated while KYC verification is in progress, please try again when the verification process has been completed.",
"errors": [
"Detailed description here"
]
}{
"error_code": "CHANNEL_HAS_BEEN_ACTIVATED",
"message": "The payment channel requested has already been activated for this account holder.",
"errors": [
"Detailed description here"
]
}Forbidden request
{
"value": {
"event": "account_holder.kyc.status",
"created": "2021-01-01T10:00:00Z",
"business_id": "5fe2b0137b7d62542fe6d7de",
"data": {
"id": "57fb4e076fa3fa296b7f5a97",
"created": "2021-01-01T10:00:00Z",
"updated": "2021-01-01T10:00:00Z",
"capabilities": [
{
"type": "MONEY_IN",
"channel_code": "GCASH",
"activated_at": "2021-01-01T10:00:00Z",
"verified_at": "2021-01-01T10:00:00Z",
"requested_at": "2021-01-01T10:00:00Z",
"status": "RESUBMISSION_REQUIRED",
"failure_reason": "Your website URL is not related to your business"
}
]
}
}
}Event that occurred for this webhook
ID of your Account, use this in the for-user-id header to create transactions on behalf of your Account
Timestamp of when the webhook was sent
Timestamp of when the webhook was updated
The unique ID of an Account Holder object
Timestamp of when the webhook was sent
Timestamp of when the webhook was updated
An object containing the details of the Account Holder capabilities activation process
Timestamp of when the object was updated
Timestamp of when the object was updated
Timestamp of when the object was updated
OK