Tu cuenta
| Concepto | Qué es |
|---|
| Organización | Tu empresa. Todos tus datos quedan aislados de los de otras organizaciones. |
| Aplicación | Un sistema tuyo que consume la API (tu e-commerce, tu app de reservas…). Es SANDBOX o PRODUCTION y tiene sus propias API keys y endpoints de webhook. |
Comercio (merchant_account_id, mrc_…) | La unidad comercial que cobra, en pesos chilenos (CLP). |
| Proveedor del comercio | Un proveedor habilitado para un comercio, con su modo (MOCK, SANDBOX, PRODUCTION) y su prioridad. Ver Proveedores y routing. |
| API key | La credencial de tu aplicación. Se muestra una sola vez al crearla; después solo ves su prefijo. |
El pago
| Concepto | Qué es |
|---|
| Payment intent | La intención de cobro: monto, moneda, tu external_reference, a dónde volver (return_url), el proveedor pedido y el que efectivamente se usó, su estado y el registro de sus eventos. Es el objeto con el que trabajas casi siempre. |
| Payment | Aparece cuando el proveedor autoriza el cobro. Es sobre lo que se hacen las devoluciones. |
| Refund | Una devolución sobre un payment. Puede ser parcial o total; la suma nunca supera lo autorizado. |
Un payment intent puede tener más de un intento de checkout (por ejemplo, si el comprador abandona y
vuelves a pedir el checkout). Eso lo maneja la plataforma: tú sigues trabajando con el mismo payi_….
Identificadores
Los ids llevan un prefijo que indica su tipo, así se reconocen a simple vista en logs y en soporte:
| Prefijo | Qué identifica |
|---|
payi_ | payment intent |
pay_ | payment |
ref_ | refund |
mrc_ | comercio |
apc_ | API key |
whe_ | webhook endpoint |
whd_ | entrega de un webhook |
evt_ | evento |
Proveedores
| Valor en la API | Proveedor | Checkout |
|---|
transbank_webpay_plus | Transbank Webpay Plus | redirect POST con token_ws |
mercadopago_checkout_pro | Mercado Pago Checkout Pro | redirect GET a la URL de checkout |
auto | el primer proveedor habilitado y disponible del comercio, según su prioridad | — |
Montos y moneda
currency es CLP.amount es un entero mayor que cero, en pesos (CLP no tiene decimales): 25990 son
$25.990.