Query submerchant status by requestId/submerchantId
https://api-uat.kushkipagos.com
https://api-uat.kushkipagos.com
GET
/onboarding/v1/submerchants
Revisa la notificación por webhook para confirmar que el subcomercio llegó al estado READY_FOR_ONBOARDING. Eso indica que el proceso de validación fue exitoso.
Cómo usar este endpoint
requestId asociado al lote.submerchantId correspondiente.Manejo de la respuesta
requestId, la respuesta incluye un array de subcomercios, cada uno con su estado de creación.submerchantId, la respuesta devuelve un único objeto con los detalles de ese subcomercio.Estados del subcomercio
Para saber si el subcomercio entró al proceso de onboarding
READY_FOR_ONBOARDING- El subcomercio pasó la validación y está listo para el proceso de onboardingERROR- La creación del subcomercio falló por problemas de validación o de procesamiento. Debes corregir el problema y volver a enviar la solicitud de creación con los ajustes necesarios.Para seguir el avance del onboarding
Solo los subcomercios con estado READY_FOR_ONBOARDINGcontinúan el proceso de onboarding y exponen las actualizaciones de estado posteriores.
Cada subcomercio de la respuesta puede tener uno de los siguientes estados:
Rejected – El subcomercio no fue aprobado. El proceso de onboarding terminó sin éxito.PSP Pending Information – El subcomercio tiene tareas pendientes en el portal del PSP que debes completar para continuar.Kushki KYC: Ongoing – Kushki está revisando la información del subcomercio. Si se requiere información adicional, el estado cambia a PSP Pending Information; si no, el proceso continúa a la fase de creación de la cuenta.Kushki Account Creation: Ongoing – La cuenta del subcomercio se está creando en los sistemas de Kushki. No necesitas hacer nada.Approved with Conditions – Aprobado, pero debe completar tareas específicas de Post-Producción listadas en el portal.Approved – Totalmente aprobado y listo para operarRequest
Query Params
Header Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/onboarding/v1/submerchants?requestId=&submerchantId=' \
--header 'X-Api-Key;'Response Response Example
200 - Query by submerchantId
{
"requestId": "5c91b0ee-677f-448e-b2e8-eb13bf2efcab",
"submerchantId": "c0d99b38-9590-49fc-b348-899affe20726",
"status": "ERROR",
"message": "Submerchant onboarding failed due to invalid fields.",
"errorDetails": {
"message": "Submerchant Onboarding Request has failed",
"fields": {
"ubo": {
"uboSecondLastName": "",
"uboFirstLastName": "",
"disabled": true,
"uboFirstName": "",
"uboDateBirth": ""
},
"entityType": "",
"operationCountry": "Operation Country not registered",
"emails": "",
"subLegalName": "",
"subPostalCode": "",
"legalRepresentative": {
"legalRepresentativeName": "",
"legalRepresentativeSecondLastName": "Second Last Name is invalid",
"legalRepresentativeFirstLastName": "Value have not valid characters",
"disabled": false,
"legalRepresentativeDateBirth": "",
"legalRepresentativeIdNumber": "",
"legalRepresentativeSameAsUbo": ""
},
"submerchantAddress": "",
"submerchantCity": "",
"submerchantUrl": "",
"submerchantTaxId": "",
"submerchantName": "",
"submerchantMcc": "",
"pspCustomerId": "Select a valid operation country",
"operationType": "Select a valid operation country",
"submerchantCountryTaxResidency": "",
"secondConcurrenceNeeded": ""
}
}
}Modified at 2026-09-03 23:43:22