Verification
Submit Partner KYC Verification
Submit pre-verified KYC screening results and document information from a partner platform. PayMongo verifies the screening data via the Verifications API and marks the account's identity verification as passed if validation succeeds.
The endpoint integrates with the Verifications API to validate the partner verification data. Document information and screening results are validated against PayMongo's compliance requirements.
This endpoint does not activate the account. After partner verification is submitted, you should populate additional person and business details via the Update Account endpoint, then activate the account separately.
Only the parent account can submit partner verification data for child accounts. The partner platform must be pre-approved and enabled by PayMongo for KYC Reliance.
post/v2/accounts/{account_id}/partner_verification
Request
- Base URLhttps://api.paymongo.com
- URLhttps://api.paymongo.com/v2/accounts/{account_id}/partner_verification
- AuthHTTP basic
Path parameters
account_idstring required
Unique identifier for the account
Request body
Example request
{
"risk_profile": {
"verification": {
"source": "TestPartner",
"partner_verification_id": "kyc_rel_001",
"verified_at": "2026-05-12T12:00:00Z",
"next_verification_refresh_schedule": "2027-05-12T12:00:00Z"
}
},
"documents": [
{
"type": "national_id_ph",
"id_number": "1234-5678-9101-1213",
"front_image_url": "https://httpbin.org/image/jpeg",
"back_image_url": "https://httpbin.org/image/jpeg",
"metadata": {
"first_name": "John",
"last_name": "Doe",
"date_of_birth": "1990-01-15"
}
}
],
"person": {
"first_name": "Juan",
"last_name": "Dela Cruz",
"middle_name": "Clara",
"mobile_number": "+639569999999",
"email_address": "juan@delacruz.com",
"date_of_birth": {
"day": 1,
"month": 1,
"year": 1990
},
"nationality": "PHL",
"nature_of_work": "employed_locally",
"place_of_birth": {
"city": "Manila",
"country": "PH"
},
"source_of_funds": "salary",
"source_of_funds_salary": "ABC Corporation",
"tin": "123-456-789",
"address": {
"line1": "123 Main St",
"line2": "Apt 4B",
"city": "Makati",
"state": "PH-MNL",
"country": "PH",
"postal_code": "1234"
},
"permanent_address": {
"line1": "123 Main St",
"line2": "Apt 4B",
"city": "Makati",
"state": "PH-MNL",
"country": "PH",
"postal_code": "1234"
}
},
"business": {
"address": {
"line1": "456 Business Ave",
"line2": "Floor 10",
"city": "Makati",
"state": "PH-MNL",
"country": "PH",
"postal_code": "1234"
},
"age": "between_1_and_2_years",
"description": "E-commerce store selling electronics",
"email": "business@example.com",
"estimated_monthly_volume": "between_300K_and_500K",
"category": "shopping",
"legal_name": "ABC Corporation",
"physical_store": true,
"registration_number": "DTI-123456",
"sector": "electronics",
"size": "less_than_10",
"support_email": "support@example.com",
"customer_service_number": "+639171234567",
"tin": "123-456-789-000",
"trade_name": "ABC Store",
"type": "corporation",
"website": "https://example.com"
},
"ubos": [
{
"first_name": "Juan",
"last_name": "Dela Cruz",
"middle_name": "Santos",
"date_of_birth": {
"day": 1,
"month": 1,
"year": 1990
},
"nationality": "PHL",
"ownership_percentage": 100,
"phone_number": "+639171234567",
"email_address": "juan@example.com",
"tax_id": "123-456-789",
"address": {
"line1": "456 Business Ave",
"line2": "Floor 10",
"city": "Makati",
"state": "PH-MNL",
"country": "PH",
"postal_code": "1234"
}
}
]
}Response
Partner verification submitted successfully - identity marked as verified via KYC reliance
Example response
{
"data": {
"id": "org_ac527a0acdc42ac430606e7b",
"type": "consumer",
"activation_status": "pending",
"person": {
"type": "representative",
"first_name": "Juan",
"last_name": "Dela Cruz",
"middle_name": "Clara",
"mobile_number": "+639569999999",
"email_address": "juan@delacruz.com",
"date_of_birth": {
"day": 1,
"month": 1,
"year": 1990
},
"nationality": "PHL",
"nature_of_work": "employed_locally",
"place_of_birth": {
"city": "Manila",
"country": "PH"
},
"source_of_funds": "salary",
"source_of_funds_salary": "ABC Corporation",
"tin": "123-456-789",
"address": {
"line1": "123 Main St",
"line2": "Apt 4B",
"city": "Makati",
"state": "PH-MNL",
"country": "PH",
"postal_code": "1234"
},
"permanent_address": {
"line1": "123 Main St",
"line2": "Apt 4B",
"city": "Makati",
"state": "PH-MNL",
"country": "PH",
"postal_code": "1234"
},
"identity_verification_status": "pending"
},
"business": {
"address": {
"line1": "456 Business Ave",
"line2": "Floor 10",
"city": "Makati",
"state": "PH-MNL",
"country": "PH",
"postal_code": "1234"
},
"age": "between_1_and_2_years",
"customer_service_number": "+639171234567",
"date_of_incorporation": {
"day": 1,
"month": 1,
"year": 1990
},
"description": "E-commerce store selling electronics",
"dti_registered_name": "ABC Trading",
"estimated_monthly_volume": "between_300K_and_500K",
"handle": "abc-store",
"industry": "5999",
"legal_name": "ABC Corporation",
"physical_store": true,
"registration_number": "DTI-123456",
"size": "less_than_10",
"tin": "123-456-789-000",
"trade_name": "ABC Store",
"type": "corporation",
"website": "https://example.com"
},
"created_at": 1714929600,
"updated_at": 1714929600
}
}Changes
No recorded changes to this operation across all 1 revision of this API.