Get submerchantIds

https://api-uat.kushkipagos.com

GET

/onboarding/v1/psp/submerchantIds

Este endpoint permite a los Payment Service Providers (PSPs) obtener los IDs de todos los subcomercios que completaron el proceso de onboarding. Es útil para los PSPs que necesitan listar sus subcomercios activos de forma programática.

Solo aparecen en la respuesta los subcomercios aprobados y creados por completo.

Parámetro de consulta: fullResponse
Por defecto (fullResponse=false u omitido), la respuesta devuelve un array plano de strings con los IDs de los subcomercios.

Cuando envías fullResponse=true, cada elemento de submerchatIds se devuelve como un objeto que contiene el id y el nombre del subcomercio. Es útil para identificar subcomercios por nombre sin hacer una consulta adicional.

Cada ítem incluye:

idPsp – El identificador único del PSP.

submerchantsIds - Un array con todos los submerchantIds correspondientes al PSP.

Request

Query Params

Header Params

Responses

🟢200OK

application/json

Respuesta exitosa

Bodyapplication/json

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location '/onboarding/v1/psp/submerchantIds?fullResponse=undefined' \
--header 'X-Api-Key;'

Response Example

200 - Full response (fullResponse=true)

{
    "idPsp": "122",
    "submerchatIds": [
        {
            "id": "20000000101933870000",
            "name": "Caso 2 RISK"
        },
        {
            "id": "20000000106045330000",
            "name": "Merchant Ejemplo Colombia"
        },
        {
            "id": "20000000102324298000",
            "name": "Tienda Demo Perú"
        }
    ]
}

Modified at 2026-09-03 23:43:30

Query submerchant status by requestId/submerchantId

Get credentials for submerchants