Payins y depósitos

Toda entrada de dinero es un payin: estados, regla pending → settled y cuenta de depósito por MID.

Un payin es toda entrada de dinero a tu comercio, venga de un link de pago o de un depósito. Es el objeto que debes consultar para saber si ya recibiste el dinero.

Estados

Estados de un payin
pending
Pago validado
settled
Reembolso totalrefunded
Vencidoexpired
Fallidofailed
  • Todo payin nace en pending.
  • Solo se liquida desde pending y solo después de que Clobepay valida el pago (monto y activo exactos). Un payin expired o failed nunca pasa a settled por sí solo.
  • settledAt es cuándo se dio por bueno; availableAt es cuándo el saldo queda disponible (mientras sea futuro, aparece como «Por liquidar»).
  • Montos como texto decimal; el activo de liquidación es USDT.

Origen

El campo source indica de dónde vino: payment_link, deposit_account, bank_transfer, crypto_deposit o internal_transfer.

Consultar

Filtros de GET /payins: status, source, from, to, limit y startingAfter (paginación por cursor).

curl -X GET "$CLOBEPAY_API_BASE/payins?status=pending&limit=10" \  -H "Authorization: Bearer $CLOBEPAY_API_KEY"

Respuesta

HTTP 200
{
  "object": "list",
  "data": [
    {
      "id": "pi_3Kx9mQ2vR8wL0tYbA4nC1e",
      "object": "payin",
      "status": "pending",
      "source": "payment_link",
      "amount": "50.00",
      "asset": "USDT",
      "providerFee": null,
      "netAmount": null,
      "paymentLinkId": "7c2e1a4b-9d83-4f21-a6b0-2e8c91f04d17",
      "providerReference": null,
      "settledAt": null,
      "availableAt": null,
      "refundedAt": null,
      "metadata": {
        "cart_id": "c_77"
      },
      "createdAt": "2026-11-19T18:00:00.000Z",
      "updatedAt": "2026-11-19T18:00:00.000Z"
    }
  ],
  "hasMore": false
}

Cuenta de depósito por comercio

Para recibir transferencias bancarias sin crear un link por cada una, cada comercio tiene su propia cuenta de depósito (en México, una CLABE). Cada depósito que llegue a esa cuenta se registra como un payin de tu comercio con source = deposit_account y sigue la misma regla pending → settled.

En México la cuenta es una CLABE. POST /deposit-accounts exige Idempotency-Keyy el cuerpo { "currency": "MXN" }. Si ya existe una cuenta en esa moneda, la API devuelve la misma (HTTP 200). Cada abono a esa cuenta llega como un payin con source = deposit_account y sigue pending → settled. Recibirás deposit_account.created al darla de alta y payin.settled cuando el depósito quede liquidado.

curl -X POST "$CLOBEPAY_API_BASE/deposit-accounts" \  -H "Idempotency-Key: deposit-mxn-1" \  -H "Authorization: Bearer $CLOBEPAY_API_KEY" \  -H "Content-Type: application/json" \  -d '{"currency":"MXN"}'

Respuesta

{
  "id": "c5d18a90-4e27-4b6f-91c2-7a8e3d5f0146",
  "object": "deposit_account",
  "currency": "MXN",
  "country": "MX",
  "accountNumber": "646180110400000000",
  "bankName": "Example Bank",
  "status": "active",
  "createdAt": "2026-11-19T18:00:00.000Z"
}