post https://penny-api-restricted-dev.alfredpay.io/api/v1/third-party-service/penny/customers//kyb
This endpoint accepts a JSON payload with the business KYB submission data.
Request body shape (field types and rules):
- kybSubmission.country: (string) 2-letter country code. Allowed values: AR, CO, BR, MX, CN, HK. Required.
- kybSubmission.businessName: (string) Business name. Required.
- kybSubmission.taxId: (string) Business tax identifier. Required.
- kybSubmission.state: (string) State or province. Required.
- kybSubmission.city: (string) City. Required.
- kybSubmission.address: (string) Street address. Required.
- kybSubmission.zipCode: (string) Postal / zip code. Required.
- kybSubmission.website: (string) Optional website URL.
- kybSubmission.relatedPersons: (array) At least one related person object is required. Each related person must include:
- firstName: (string) Required.
- lastName: (string) Required.
- email: (string) Valid email. Required.
- dateOfBirth: (string | date) Date in ISO format (e.g. 2003-01-01). Required.
- nationalities: (array) Optional but if provided must have at least one entry.
- cpf | dni | pep: (string) Optional identity fields.
Validation: the controller uses class-validator decorators on DTOs; fields marked required will be validated and non-whitelisted properties will be stripped.
Example request body: { "kybSubmission": { "country": "MX", "businessName": "ACME S.A.", "taxId": "XAXX010101000", "state": "CDMX", "city": "Ciudad de México", "address": "Av. Siempre Viva 123", "zipCode": "01234", "website": "https://example.com", "relatedPersons": [ { "firstName": "Juan", "lastName": "Perez", "email": "[email protected]", "dateOfBirth": "1980-05-01", "nationalities": ["MX"] } ] } }