Cuentas de Depósito

Usa el endpoint de bank-income para obtener los datos de la cuenta donde tu merchant debe enviar fondos para fondear su balance.

Endpoint

GET /api/v1/organizations/{organizationId}/merchants/{merchantId}/bankIncome/accounts

Qué Recibes

Según el país, la respuesta puede incluir:

número de cuenta virtual, CLABE o CVU
alias cuando aplique
routing number para flujos de fondeo en EE. UU.
datos bancarios fijos del beneficiario para algunos países

Flujo Típico de Fondeo

Obtener instrucciones de depósito

Consulta los datos actuales del merchant.

Enviar la transferencia bancaria

Inicia la transferencia desde tu cuenta operativa o de tesorería.

Esperar la acreditación

Cuando la transferencia liquide, el balance queda disponible para PAYOUT, transferencias u operaciones cripto.

Verificar balances

Confirma los fondos con los endpoints de balances antes de crear flujos posteriores.

Ejemplo


curl -X GET 'https://api-sandbox.koywe.com/api/v1/organizations/TU_ORG_ID/merchants/TU_MERCHANT_ID/bankIncome/accounts' \
  -H 'Authorization: Bearer TU_TOKEN'

Endpoints Relacionados

GET /api/v1/organizations/{organizationId}/merchants/{merchantId}/accounts/balances
GET /api/v1/organizations/{organizationId}/balances

Buenas Prácticas

No caches estas instrucciones indefinidamente; consulta datos vigentes cuando construyas el flujo operativo.
Usa el mismo merchant y organization para fondeo y para operaciones posteriores.
Espera acreditación confirmada antes de crear flujos dependientes de balance.