Payment Intents

{
  "id":            "ef0cb276-399a-4c21-b33b-ea63ddc48246",   // UUID string
  "object":        "payment_intent",                          // literal fijo
  "amount":        5.0,                                       // monto pedido
  "currency":      "USDT",                                    // asset principal, MAYÚSCULAS
  "status":        "pending",                                 // pending | completed | expired | failed
  "ref_code":      "EDEA9",                                   // id de 5 chars para hosted page
  "external_ref":  "user_42",                                 // tu clave de atribución (o null)
  "description":   null,                                      // proporcionado por el partner (o null)
  "metadata":      null,                                      // objeto opcional del partner (o null)
  "addresses": [                                              // destinos por (asset, red)
    {
      "asset":   "USDT",
      "network": "sol",                                       // código lowercase (o null en race del catálogo)
      "address": "zSAND9FBqeoVb9mDr2tBKWiBtPGZfq8f"           // wallet on-chain, verbatim
    }
  ],
  "created_at":    "2026-06-09T19:40:13.042621Z",
  "expires_at":    "2026-06-10T19:40:13.195347Z",
  "completed_at":  null,                                      // se setea al pasar a completed

  "deposit":       null,                                      // detalles del ÚLTIMO crédito on-chain
                                                              // (ver "El objeto deposit" abajo)

  "amount_received":   0.0,                                   // suma acumulada de depósitos completados
  "amount_remaining":  5.0,                                   // max(0, amount - amount_received)
  "partial_payment":   false                                  // booleano canónico "está incompleto"
}

                    POST /payment-intents
                              │
                              ▼
                       ┌──────────┐
                       │ pending  │  ◄──── intents arrancan aquí
                       └────┬─────┘
                            │
        ┌───────────────────┼────────────────────┐
        │                   │                    │
        │ (acumulado >=     │ (expires_at        │ (depósito parcial
        │  amount, dentro   │  alcanzado sin     │  llega; el intent
        │  de 0.01 de       │  pago completo)    │  se queda aquí)
        │  tolerancia)      │                    │
        ▼                   ▼                    │
   ┌──────────┐       ┌──────────┐               │
   │completed │       │ expired  │               │
   └──────────┘       └──────────┘               │
                                                 │
                       (sin transición) ◄────────┘

T=0      POST /payment-intents → minteado
         status=pending  amount_received=0.0  partial_payment=false  amount_remaining=5.0

T=10s    Depósito de $3 aterriza on-chain
         status=pending  amount_received=3.0  partial_payment=true   amount_remaining=2.0
         deposit = { amount_received: 3.0, ... }    ◄── detalles del último crédito

T=60s    Depósito de $2 aterriza on-chain
         status=completed completed_at=<T+60s>  partial_payment=false  amount_remaining=0.0
         amount_received=5.0
         deposit = { amount_received: 2.0, ... }    ◄── ÚLTIMO, no acumulado

         (webhook payment.completed dispara aquí)

async function poll(intentId: string) {
  const intent = await fetch(`/api/zopay/status/${intentId}`).then(r => r.json());

  if (intent.status === "completed")  return onSuccess(intent.deposit);
  if (intent.status === "expired")    return intent.amount_received > 0
                                          ? onExpiredWithCredits(intent.amount_received)
                                          : onExpired();
  if (intent.partial_payment)         return showPartialUI(
                                          intent.amount_received,
                                          intent.amount_remaining
                                        );

  // status === "pending", amount_received === 0 → intent fresco, esperando primer crédito.
  return showWaitingUI();
}

{
  "deposit": {
    "amount_received":   5.0,                                  // amount de ESTE crédito, no acumulado
    "currency":          "USDT",
    "network":           "sol",
    "address_receiver":  "zSAND9FBqeoVb9mDr2tBKWiBtPGZfq8f",
    "address_sender":    "zSAND_simulator_sender",             // "..._simulator_sender" en sandbox
    "tx_hash":           "5cc7a1fa..."                         // hash on-chain (determinístico en sandbox)
  }
}