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
- Todo payin nace en
pending. - Solo se liquida desde
pendingy solo después de que Clobepay valida el pago (monto y activo exactos). Un payinexpiredofailednunca pasa asettledpor sí solo. settledAtes cuándo se dio por bueno;availableAtes 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"
}