Koywe
En esta página

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

  1. Obtener instrucciones de depósito

    Consulta los datos actuales del merchant.

  2. Enviar la transferencia bancaria

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

  3. Esperar la acreditación

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

  4. Verificar balances

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

Ejemplo

Terminal
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.

Siguientes Pasos