1. Appian - Submerchant Register
Español
  • English
  • Español
  • Docs para desarrolladores 🇪🇨
  • Online Payments
    • Notas de versión
    • Errores del API de Kushki
    • Card Payments
      • Solicitar un token de tarjeta
      • Hacer un cargo o cargo diferido
      • Reembolsar una transacción
      • Anular una transacción
      • Solicitar opciones de diferido
      • Validar OTP
      • Información de BIN V2
      • Información de BIN
    • One Click and Scheduled Payments
      • Solicitar un token de cargo recurrente
      • Crear un cargo recurrente
      • Actualizar los datos de la tarjeta del cargo recurrente
      • Hacer un pago One-click
      • Cancelar un cargo recurrente
      • Actualizar un cargo recurrente
      • Agregar un cargo o descuento temporal
      • Consultar información del cargo recurrente
    • Chargebacks
      • Consultar chargebacks
      • Solicitar exportación de chargebacks
    • Subscription Transactions
      • Consultar transacciones de suscripción
    • Cash in
      • Solicitar un token de Cash In
      • Iniciar transacción
      • Actualizar una transacción de Cash In
      • Estado de la transacción
      • Eliminar una transacción de Cash In
    • Transfer in
      • Solicitar un token de Transfer In
      • Iniciar transacción
      • Consultar estado
    • Analytics
      • Consultar listado de transacciones v2
    • Smartlinks
      • Crear un Smartlink
      • Actualizar un Smartlink
      • Consultar un Smartlink
      • Eliminar un Smartlink
    • Status
      • Consultar estado del gateway
      • Consultar estado de la plataforma
    • Commissions
      • Consultar configuración de comisiones
    • Payment Credentials
      • Crear una credencial
      • Buscar credenciales
      • Activar o desactivar
      • Eliminar credencial
      • Actualizar credencial
      • Regenerar una credencial
      • Búsqueda avanzada
    • Payment Button
      • Crear un Payment Button
    • Settlement
      • Consultar liquidación
  • Appian - Submerchant Register
    • Release Notes
    • Submerchant Validation in Batch
      POST
    • Query submerchant status by requestId/submerchantId
      GET
    • Get submerchantIds
      GET
    • Get credentials for submerchants
      POST
  • Schemas
    • threeDomainSecure
    • Card-old
    • Channel
    • SubscriptionTransactionsResponse
    • Card Present (CP)
    • Amount-cash-in
    • webhooks
    • ChargebackListResponse
    • StatusComponent
    • SettlementDateRangeRequest
    • Card
    • networkToken
    • ChargebackItem
    • SettlementRecord
    • Card Not Present (CNP)
    • currency
    • ErrorResponse
    • SubscriptionTransaction
    • Subscription
    • Amount
    • ErrorResponse400
    • SettlementResponse
    • Country
    • Deferred
    • extraTaxes
    • ErrorResponse401
    • Language
    • ErrorResponse403
    • Metadata
    • payment_method
    • ErrorResponse500
    • ContactDetails
    • orderDetails
    • Shipping Address
    • Billing-Address
    • payment_submethod
    • SubscriptionUpdate
    • documentType
    • SubscriptionAdjustmentRequest
    • threeDomainSecure
    • webhooks
    • headers
    • webhooksChargeback
    • citMit
    • network
    • binInfo
    • messageFields
    • UnexpectedErrorResponse
    • ExternalReferenceId
    • product
    • transactionType
    • SettlementTicketRequest
HomePerú 🇵🇪México 🇲🇽Ecuador 🇪🇨
Colombia 🇨🇴Chile 🇨🇱
HomePerú 🇵🇪México 🇲🇽Ecuador 🇪🇨
Colombia 🇨🇴Chile 🇨🇱
  1. Appian - Submerchant Register

Get credentials for submerchants

https://api-uat.kushkipagos.com
https://api-uat.kushkipagos.com
POST
/onboarding/v1/psp/credentials
Permite a un PSP (Payment Service Provider) obtener las credenciales transaccionales (llaves pública y privada) de uno o más subcomercios ya creados en Kushki.
Este endpoint se autentica con la PSP API Key, que se genera desde el portal de Appian. Está diseñado para PSPs que gestionan múltiples comercios dentro de su ecosistema y necesitan acceso seguro a las credenciales de cada subcomercio.

Consideraciones importantes#

Puedes enviar varios merchantIds en una sola solicitud.
En las respuestas exitosas, los valores publicCredential y privateCredential devueltos son las llaves que se usan en las operaciones transaccionales, como cargos y suscripciones.
Este endpoint solo devuelve credenciales de subcomercios asociados al PSP autenticado.
Si un merchantId no es válido o no cumple los criterios, la API devuelve el submerchantId y un message descriptivo.
The submerchant does not belong to the authenticated PSP: el ID es válido pero pertenece a otro PSP.
Submerchant not found: el ID no existe en el sistema o el proceso de onboarding aún no está completo.

Request

Header Params

Body Params application/json

Examples

Responses

🟢201Created
application/json
Created
Bodyapplication/json

🟠400Bad Request
🟠403Forbidden
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/onboarding/v1/psp/credentials' \
--header 'X-Api-Key;' \
--header 'Content-Type: application/json' \
--data '{
    "submerchantIds": [
        "20090200103691174000",
        "00000000108451820000",
        "80000000101279730000",
        "10000000103480033000"
    ]
}'
Response Response Example
201 - 201 Created
{
    "pspId": "138",
    "credentials": [
        {
            "submerchantId": "20000000123456789000",
            "publicCredential": "a1b2c3d4e5f64718a9b01234abcd5678",
            "privateCredential": "f1e2d3c4b5a60987cdef1234abcd5678"
        },
        {
            "submerchantId": "20000000987654321000",
            "publicCredential": "1234abcd5678ef9012bc3456de7890fa",
            "privateCredential": "abcd1234ef5612cd7890ab34cdef5678"
        },
        {
            "submerchantId": "99999999123456780000",
            "message": "The submerchant does not belong to the authenticated PSP"
        }
    ]
}
Modified at 2026-09-03 23:43:39
Previous
Get submerchantIds
Next
threeDomainSecure-old
Built with