Query submerchant status by requestId/submerchantId
GET
/onboarding/v1/submerchants
Make sure to check the webhook notification to confirm that the submerchant has reached the READY_FOR_ONBOARDINGstatus. This indicates the validation process was successful.
How to Use This Endpoint
requestId associated with the batch.submerchantId.Response Handling
requestId, the response includes an array of submerchants, each with their creation status.submerchantId, the response returns a single object containing details for that submerchant.Only for submerchants with the Operation Country: Mexico (MX)
When a submerchant is in thePSP Pending Informationstatus, the response is enhanced to include thependingDocumentsarray, giving the PSP visibility into which documents are required to complete the task.
Submerchant Statuses
To determine if the submerchant entered the onboarding process
READY_FOR_ONBOARDING- The submerchant has passed validation and is ready for the onboarding processERROR- The submerchant creation failed due to validation or processing issues. The issue must be corrected and the creation request resubmitted with the appropriate adjustments.To track the onboarding progress
Only submerchants with the READY_FOR_ONBOARDINGstatus will continue through the onboarding process and expose subsequent status updates.
Each submerchant in the response can have one of the following statuses:
Rejected – The submerchant was not approved. The onboarding process has ended unsuccessfully.PSP Pending Information – The submerchant has pending tasks in the PSP portal that must be completed to continue. Important: For Mexico (MX) submerchants, this status will include the pendingDocuments array in the response to detail which specific documents are pending submission or review.Kushki KYC: Ongoing – Kushki is reviewing the submerchant's information. If additional input is required, the status will change to PSP Pending Information; otherwise, the process will continue to the account creation phase.Kushki Account Creation: Ongoing – The submerchant's account is being created in Kushki's systems. No action needed.Approved with Conditions – Approved, but must complete specific Post-Production tasks listed in the portal.Approved – Fully approved and ready to operateRequest
Query Params
Header Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api-uat.kushkipagos.com/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-07-31 15:34:20