Generate Controller Beneficiaries PDF
Version: 1.0.0 | Free: December 2024
Description
That automatically generates a PDF document for the "Controller Beneficiaries Identification Format" of SAT (Annex 3 for natural persons).
Endpoint
GET https://api.jaak.ai/api/v1/kyc/session/{sessionId}/beneficiary-controller-pdf
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
sessionId | path | Yes | Session identifier KYC |
Authorization | Leader | Yes | API Key or Bearer Token |
Language | Leader | No | "es" o "en" (default: Spanish) |
Authentication methods
# API Key
Authorization: YOUR_API_KEY
# Bearer Token
Authorization: Bearer [JWT_TOKEN]
Reels permitted: Reg, Reg (Reg only)
Response
Success (200 OK)
Content-Type: application/pdf
Content-Disposition: attachment; filename="beneficiario_controlador_{sessionId}.pdf"
Body: binary PDF file
Error Codes
| Code | Description |
|---|---|
| 400 | Invalid session ID format |
| 401 | Invalid / expired credentials |
| 403 | Insufficient permits |
| 404 (KYC19) | No meeting |
| 500 | PDF Generation Failed |
PDF content
The document automatically includes:
- Full personal information (names, date of birth, nationality, gender)
- CURP and RFC
- Document identification details
- Full address information
- Check contact details (phone / email)
- Facial photo
- Company logo (if set)
- Generation Timestamp
Recommended Integration Flow
1. To login KYC → get sessionId
2. User complete the verification process
3. Confirmar estado de sesión = "completed"
4. Call PDF Generation endpoint
5. Store PDF on system
6. To associate with the client's registry
Best Practices
Do:
- Check that session KYC be "complete" before applying for PDF
- Download immediately after completion
- Using descriptive file names with sessionId
- Validar Content-Type as "application / pdf"
- Implement exponential backoff for errors 500
Avoid:
- Simultaneous duplicate applications
- Assign PDF availability without checking status
- Ignore mistakes 404
- Store Unvalidated downloads
Environments
| Environment | URL |
|---|---|
| Sandbox | https://api.sandbox.jaak.ai |
| Production | https://api.jaak.ai |
Compliance information
The endpoint generates documents in conformity with:
- Specifications of the Annex 3 format SAT
- Mexican anti-money laundering regulations
- Current official identification requirements
- Federal regulations for illicit income prevention
Support
- Email: support
- Portal: https://app.jaak.ai
- Documentation: https://docs.jaak.ai
- Hours: Lunes-Friday 9am-6pm, Saturday 10am-2pm (Mexico City time)