Deposit Accounts - Kushki Developer Portal

Registra una cuenta CLABE de depósito nueva o actualiza una existente, con control sobre cuál cuenta recibe los fondos de forma predeterminada.

INFO

Servicio disponible solo en México.

Requisitos

Una cuenta válida

Una API key

La cuenta CLABE que vas a registrar o modificar

Entornos

Entorno	URL base
Dev	`https://milos.billpocket.dev`
Live	`https://milos.billpocket.com`

Autenticación

Envía tu user token en X-BP-UserToken y tu API key en BP-Api-Key.

Agregar o actualizar una cuenta CLABE

POST /users/set-clabe

Registra una cuenta CLABE nueva o actualiza una existente.

WARNING

Espera 30 segundos entre solicitudes consecutivas de registro o modificación de cuentas para el mismo usuario.

Solicitud:

{
  "email": "john.doe@example.com",
  "tipo_cuenta": "1",
  "referencia": "012345678900000007",
  "default": true
}

Campo	Tipo	Obligatorio	Descripción
`email`	string	✅	Correo del usuario
`tipo_cuenta`	string	✅	Tipo de cuenta (`"1"` = CLABE)
`referencia`	string	✅	Número de cuenta CLABE de 18 dígitos
`default`	boolean	✅	`true` = se define como cuenta de depósito predeterminada

Respuesta:

Devuelve HTTP 200 con un objeto JSON que contiene result: "Success" cuando la operación es exitosa, o result: "error" con los detalles cuando falla.

Comportamiento de la cuenta predeterminada

Valor de `default`	Resultado
`true`	La CLABE se registra y queda como cuenta de depósito predeterminada
`false`	La CLABE se registra pero no queda como predeterminada

Siguientes pasos

Revisa la referencia de la API de Cuentas de depósito

¿Tienes una sugerencia sobre esta documentación? Contáctanos.

Cuentas de depósito

Requisitos#

Entornos#

Autenticación#

Agregar o actualizar una cuenta CLABE#

Comportamiento de la cuenta predeterminada#

Siguientes pasos#

Requisitos

Entornos

Autenticación

Agregar o actualizar una cuenta CLABE

Comportamiento de la cuenta predeterminada

Siguientes pasos