Individual VA Onboarding Guide Split and Authentication Link Validity
Effective Date: 2026-11-18 (UTC+8)Scope: Entity API / Individual VA Onboarding Guides
[API] Entity Authentication URL Validity Clarified
The description of the create-entity-auth-URL endpoint now states that the returned authentication URL is valid for 1 hour. Once it expires, the user can no longer submit verification materials and a new URL must be generated.
- Applies to first-time authentication of a person entity.
- Entities that are already verified and only need to supply proof of address continue to use the POA URL endpoint.
[Guides] Individual VA Onboarding Split into Two Guides
The previous combined guide covered entity creation, identity verification and VA application in one page. It is now split into two guides:
- Individual Entity Onboarding and KYC Guide: create the person entity, obtain the authentication URL and confirm the result.
- Individual Virtual Account (VA) Application Guide: status validation, document upload and account application.
The VA guide now starts with a step that confirms whether proof of address must be supplied, which applies only to existing users who did not selectbankduring verification.
[Guides] Address Proof Moved to the VA Application Stage
Proof of address is part of the verification flow itself: when businessTypes includes bank, the user uploads it in the same verification session.
If bank was not selected, proof of address must be supplied through the POA URL endpoint before applying for a VA. This step has moved from the verification guide to the VA application guide to avoid confusion with the standard verification flow.
[Guides] VA Application Guide Adds canApplyVa=false Troubleshooting
canApplyVa=false TroubleshootingWhen kycStatus is completed but canApplyVa remains false, the usual cause is that bank was not selected during verification, so the entity has no proof of address on file.
- Supply the proof of address as described in Step 1 of the VA application guide.
- Query the entity status again after completion.
- If the proof of address is complete but
canApplyVais stillfalse, contact your account manager or operations team.
[Guides] Compliance File Format Requirements Updated
The image format restriction for individual VA account-opening documents has been relaxed from JPEG-only to PDF, JSON, JPEG or PNG.
Affected individual guides:
- Individual Entity Onboarding and KYC Guide
- Individual Virtual Account (VA) Application Guide
The equivalent statement in the Business VA Application Guide has been updated as well.
Thank you for choosing DogPay! If you encounter any issues or need assistance during integration, please feel free to reach out to the technical support team.
