HomeGuíasAPI ReferenceChangelog
Log In
API Reference

Capturar Preauthorization

Captura una autorización diferida y cierra el cobro.

Se usa para confirmar el cobro del monto retenido: el cuerpo indica la Transaction con la autorización (transaction_reference) y, opcionalmente, un amount que no supere el autorizado para capturar solo una parte. Las rutas /cl, /mx y /br son equivalentes: el país con que se contacta al medio de pago lo determina la Organization autenticada, no el prefijo de la ruta.

La captura se pide al medio de pago. Cuando este la acepta, la respuesta es 201 con la Transaction ya finalizada y su detalle completo; cuando la rechaza, la respuesta es 200 con success en false y el mensaje del medio de pago en detail.

Responde 404 cuando la Transaction no existe, y 400 cuando la Transaction no está en estado CAPTURE_PENDING o el monto pedido supera el autorizado.

Límite de tasa: 20 solicitudes por segundo. Al superarlo, la API responde 429. Ver Límites de tasa.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
enum
required

País de la organización sobre la que se opera, como primer segmento de la ruta: cl (Chile), mx (México) o br (Brasil).

Allowed:
Body Params

Captura de una autorización diferida.

number

Monto a capturar, mayor que cero y no superior al autorizado. Si se omite, la captura se pide sin monto parcial.

string

Llave con que se deduplican los reintentos de la captura; si se omite, se genera una.

string
required

Identificador público de la Transaction que tiene la autorización a capturar.

Headers
date

Versión del API para esta petición, como cualquier fecha YYYY-MM-DD. Fija el contrato de la respuesta; si se omite, se deriva de la fecha de creación de la organización.

string

Llave de API de una Account, para operar sobre esa Account en lugar de la principal.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json