| Aplicación | Un sistema tuyo que consume la API. Es SANDBOX o PRODUCTION y tiene sus API keys y webhook endpoints. |
| API key | Credencial de una aplicación (pay_sb_… o pay_live_…). Se envía como Authorization: Bearer. |
| Checkout hospedado | La página del proveedor donde el comprador paga. Tu sistema solo redirige a ella. |
| Comercio (merchant account) | La unidad comercial que cobra (mrc_…), con sus proveedores configurados. |
| Conciliación | Consulta periódica al proveedor de los pagos en curso para corregir estados si un aviso se perdió. |
| Devolución (refund) | Reembolso total o parcial de un pago autorizado (ref_…). |
| Entrega (webhook delivery) | Cada intento de enviar un evento a un webhook endpoint (whd_…). |
| Evento | Un cambio en un pago, con id único (evt_…) y tipo, por ejemplo payment.authorized. |
external_reference | Tu identificador (número de orden, reserva…). Te sirve para enlazar el pago con tu sistema. |
Idempotency-Key | Clave única por operación que permite reintentar sin duplicar efectos. |
| Payment | El pago autorizado de un intent (pay_…). Sobre él se hacen las devoluciones. |
| Payment intent | La intención de cobro (payi_…): monto, moneda, referencia, estado y eventos. |
| Proveedor | Quien procesa el cobro: Transbank Webpay Plus o Mercado Pago Checkout Pro. |
provider: auto | Deja que la API elija el proveedor según la prioridad configurada en el comercio. |
return_url | La URL de tu sistema a la que vuelve el comprador después del checkout. |
| Sandbox | Ambiente de pruebas: mismos endpoints, sin dinero real. |
| Simulador | Proveedor de mentira para sandbox, donde eliges el resultado del pago. |
| Webhook endpoint | Una URL de tu sistema registrada para recibir eventos firmados (whe_…). |