Query submerchant status by requestId/submerchantId

Make sure to check the webhook notification to confirm that the submerchant has reached the READY_FOR_ONBOARDING status. This indicates the validation process was successful.

Once a submerchant has been successfully approved, this service allows Payment Service Providers (PSPs) to check the status of submerchant creation, either for a bulk request or for a specific submerchant.

How to Use This Endpoint

To check the status of a bulk request, you must send the requestId associated with the batch.

To retrieve information about a specific submerchant, you must provide the corresponding submerchantId.

Response Handling

When querying by requestId, the response includes an array of submerchants, each with their creation status.

When querying by submerchantId, the response returns a single object containing details for that submerchant.

Submerchant Statuses

To determine if the submerchant entered the onboarding process

Each submerchant in the response can have one of the following statuses:

READY_FOR_ONBOARDING- The submerchant has passed validation and is ready for the onboarding process

ERROR- 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_ONBOARDING status 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.

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 operate

{ "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": "" } } }

Query submerchant status by requestId/submerchantId

How to Use This Endpoint#

Response Handling#

Submerchant Statuses#

To determine if the submerchant entered the onboarding process#

To track the onboarding progress#

Request

Responses

How to Use This Endpoint

Response Handling

Submerchant Statuses

To determine if the submerchant entered the onboarding process

To track the onboarding progress