Pedidos
Un pedido de pagos online puede ser creado para ser procesado de dos maneras: Modo automĂĄtico y Modo manual.
Modo automĂĄtico
El Modo automåtico, es el modo predeterminado de la aplicación. A través de este, la transacción se completa en una sola etapa y las modificaciones son limitadas. Para crear la order en modo automåtico, el campo processing_mode
, que es responsable de definir el formato de creaciĂłn y procesamiento de la transacciĂłn, vĂĄ a estar como automatic
y toda la informaciĂłn es enviada en una Ășnica solicitud.
Las operaciones permitidas son:
- Crear y procesar order: responsable por la creaciĂłn de la order y el procesamiento de la transacciĂłn en simultĂĄneo.
- Obtener order: permite obtener informaciĂłn sobre un pedido, incluido su status en tiempo real.
- Capturar order: permite capturar el monto autorizado de una order. Esta opción solo es vålida para tarjetas de crédito.
- Cancelar order: responsable de la cancelaciĂłn de una order ya existente, pero que aĂșn no ha sido procesada.
- Reembolsar order: en el caso del modo automĂĄtico, se puede crear reembolsos totales o parciales de un pago. La order serĂĄ reembolsada totalmente si todas las transacciones son reembolsadas por completo.
- Reembolso total: no se debe indicar un monto a reembolsar en el
body
de la solicitud, que debe ir vacĂo. - Reembolso parcial: se debe especificar la cantidad a reembolsar en el
body
de la solicitud, junto con el ID de la transacciĂłn. Todas las otras transacciones permanecerĂĄn como estĂĄn y solo la transacciĂłn modificada serĂĄ reembolsada.
- Reembolso total: no se debe indicar un monto a reembolsar en el
Modo manual
El Modo manual es donde podemos dividir el procesamiento de la transacciĂłn en etapas que pueden ser configuradas y ejecutadas de manera incremental. Permite la personalizaciĂłn de cada etapa del proceso de pago, adaptĂĄndose a diferentes necesidades y escenarios. Para crear la order en modo manual, es necesario asegurarse de que el campo processing_mode
, responsable de definir el formato de creación y procesamiento de la transacción, esté como manual
.
Las operaciones permitidas son:
- Crear order (con o sin transacciones): responsable por la creaciĂłn y autorizaciĂłn de la order, pero sin procesamiento en simultĂĄneo.
- Agregar transacciĂłn: esta operaciĂłn de adiciĂłn de transacciones solo puede realizarse en modo manual y es responsable de agregar mĂĄs de una transacciĂłn en un mismo payload.
- Modificar transacciĂłn y/o eliminar transacciĂłn: la modificaciĂłn y eliminaciĂłn de transacciones solo pueden realizarse en modo manual, y permiten cambiar la informaciĂłn de pago que ya se habĂa agregado anteriormente a una order. Es una operaciĂłn que modifica un elemento dentro de cualquier campo del parĂĄmetro
transactions
. - Capturar order: responsable por capturar el monto autorizado de una order. Esta opción solo es vålida para tarjetas de crédito.
- Procesar transacciĂłn: permite ejecutar las transacciones creadas y/o modificadas en modo manual.
- Obtener order: permite obtener informaciĂłn sobre un pedido, incluido su status en tiempo real.
- Cancelar order: responsable por la cancelaciĂłn de una order ya existente, pero que aĂșn no ha sido procesada/terminada.
- Reembolsar order o transacciĂłn: en modo manual se puede crear reembolsos totales o parciales de un pago. La order serĂĄ reembolsada totalmente si todas las transacciones son reembolsadas por completo.
- Reembolso total: no se debe indicar un monto a reembolsar en el
body
de la solicitud, que irĂĄ vacĂo. - Reembolso parcial: se debe especificar la cantidad a reembolsar en el
body
de la solicitud, junto con el ID de la transacciĂłn. Todas las otras transacciones permanecerĂĄn como estĂĄn y solo la transacciĂłn modificada serĂĄ reembolsada.
- Reembolso total: no se debe indicar un monto a reembolsar en el