Web Service Transaction/CancelOrRefund
El Web Service REST Transaction/CancelOrRefund permite cancelar totalmente una transacción o realizar un reembolso (total o parcial, dependiendo del adquiriente).
La anulación o el reembolso dependen del estado de la transacción.
STATUT | Anular | Reembolsar |
---|---|---|
Transaction en cours (non remisée) | Oui | NO |
Transaction remisée | Non | Sí |
Para mas información : Anular / Reembolsar una transacción.
I.Annuler
- Estado de una transacción que debe anularse:
- AUTHORISED_TO_VALIDATE(Pendiente de validación)
- WAITING_AUTHORISATION_TO_VALIDATE(Pendiente de validación y autorización)
- WAITING_AUTHORISATION(En espera de autorización)
- AUTHORISED(En espera de captura)
Más información, Ciclo de vida de las transacciones.
Anulación parcial : utilice el Web Service Transaction/Update para modificar el monto de la transacción.
Anulación total : utilice el Web Service Transaction/CancelOrRefund para anular una transacción.
II. Reembolsos
- Estado de una transacción que debe rembolsarse:
- CAPTURED(Presentado)
Rembolso parcial :
- Utilice el Web Service Transaction/CancelOrRefund y transmita un monto inferior al de la transacción.
- Puede reembolsar parcialmente muchas veces una transacción hasta hacer el reembolso total.
Rembolso total :
- Utilice el Web Service Transaction/CancelOrRefund y transmita un monto igual al de la transacción.
Casos de los impagos : Se denegará cualquier intento de reembolso de una transacción rechazada.
Caso de rechazo de reembolso :
Por ejemplo, si la solicitud de reembolso se realiza con una tarjeta bloqueada, el código y el motivo de denegación serán "59: sospecha de fraude" para determinadas entidades adquirentes.
Consulte la lista de códigos de retorno específicos de la red CB para más información.
Parámetros de la solicitud
uuid
Referencia única de la transacción generada por la plataforma de pago.
Formato
amount
Monto del pago en su fracción monetaria más pequeña (el céntimo para el euro).
Ejemplo: 30050 para 300,50 EUR.
Formato
currency
Moneda del pago. Código alfabético un mayúsculas según ISO 4217 alpha-3.
Ejemplo: "EUR" para el euro.
Formato
Valores posibles
Los valores posibles son:
Moneda | CODIFICACIÓN ISO 4217 | Unidad fraccionaria |
---|---|---|
Dólar australiano (036) | AUD | 2 |
Dólar canadiense (124) | CAD | 2 |
Franco suizo (756) | CHF | 2 |
Corona danesa (208) | DKK | 2 |
Euro (978) | EUR | 2 |
Libra esterlina (826) | GBP | 2 |
Yen (392) | JPY | 0 |
Corona noruega (578) | NOK | 2 |
Corona sueca (752) | SEK | 2 |
Dólar estadounidense (840) | USD | 2 |
resolutionMode
Una transacción puede estar autorizada y en espera de depósito bancario, o haber sido depositada. Dependiendo del estado de la entrega, existen varias operaciones posibles:
Si la transacción está pendiente de entrega:
En este caso, es posible anular la transacción. El depósito no se efectuará. El nuevo estado de la transacción será:
status | UNPAID |
detailedStatus | CANCELLED |
Si la transacción fue guardada:
En este caso, ya no es posible anular la transacción.
Deberá crear una nueva transacción de reembolso (o "refund" en inglés).
Qué hace exactamente Transaction / CancelOrRefund:
El Web Service REST Transaction/CancelOrRefund elige la operación que se realizará automáticamente.
Pero es posible forzar el tipo de operación gracias al parámetro resolutionMode.
Si el campo se envía vacío, el valor por defecto será AUTO.
Valores posibles
Los valores posibles son:
VALOR | Descripción | Anular | Reembolsar |
---|---|---|---|
AUTO | Effectue automatiquement une annulation ou un remboursement (valeur por defecto). | Sí "*" | Sí "*" |
CANCELLATION_ONLY | Effectue une annulation. Si la transaction est remisée, une erreur est retournée. | Sí | NO |
REFUND_ONLY | Effectue un remboursement. Si la transaction n'est pas remisée, une erreur est retournée. | NO | Sí |
"*" en función del estado de la transacción:
- Transacción en espera de captura: cancelación.
- Transacción entregada: reembolso.
Para más información sobre el concepto de "presentación", lea el artículo Anular / reembolsar una transacción.
Formato
comment
Comentario libre.
Formato
manualValidation
Camino: transactionOptions.cardOptions.manualValidation
Modo de validación de la transacción.
Formato
Valores posibles
Los valores posibles son:
VALOR | Descripción |
---|---|
NO | Validation automatique par la plateforme de paiement. |
YES | Validation manuelle par le marchand. |
null | Configuration par défaut de la boutique retenue (paramétrable dans le |
captureDelay
Camino: transactionOptions.cardOptions.captureDelay
Fecha límite para aplicar en la fecha de captura.
Descripción
Indica el número de días antes de la captura.
Si no se transmite este parámetro, se utiliza el valor predeterminado definido en el
Este último es configurable en el
Si el tiempo de entrega es mayor a 365 días en la solicitud de pago, se reposiciona automáticamente a 365 días.
Formato
mid
Número de la afiliación e-commerce en la que se debe realizar el reembolso de una transacción de proximidad. Si este campo es completado, asegúrese de utilizar el contrato VADS correcto en función de la red de la tarjeta.
Formato
Referencia de la respuesta
El Web Service devuelve el siguiente objeto:
Respuesta | Contexto |
---|---|
Transaction | Objeto que contiene la información de la transacción. |
Vea la referencia de la respuesta para más información.