/transactions/authorizations/{type}Autorizar
El endpoint /transactions/authorizations/{type} permite autorizar las transacciones de débito o crédito que llegan por el flujo online a la etapa de Autorización.
Te enviaremos una solicitud para autorizar o rechazar la transacción.
Consideraciones
Esperamos una respuesta rápida para garantizar una buena experiencia. Si la respuesta se demora, rechazaremos la transacción.
Además de validar la firma que te enviamos, al generar la respuesta debes firmar tu body junto con el timestamp y el endpoint de respuesta con tu api-secret luego de impactar la operación. Ten en cuenta que validaremos la firma y rechazaremos la transacción si la firma no coincide o expiró.
Puedes encontrar más información en Configuración de Webhooks.
Verificación de dirección (AVS)
AVS (Address Verification Service) permite validar el código postal y la dirección informados por el titular.
Solo aplica si tienes la validación AVS habilitada (si quieres activarla, contáctanos). Si no la tienes, no recibirás
auth_user_datani necesitas enviaravs_result.
Con la validación habilitada, todas las solicitudes incluyen el objeto auth_user_data con los campos zip_code y street_address. Cada campo trae el dato informado en la transacción o null si no vino.
Cuando un campo viene con datos, esperamos que lo valides contra los datos del titular que tienes registrados y nos informes el resultado en avs_result de tu respuesta. Este es el resultado esperado según los datos recibidos:
zip_code | street_address | avs_result esperado |
|---|---|---|
| Con dato | Con dato | FULL_MATCH si coinciden ambos; PARTIAL_MATCH_ZIP_CODE si solo coincide el código postal; PARTIAL_MATCH_STREET_ADDRESS si solo coincide la dirección; NO_MATCH si no coincide ninguno |
| Con dato | null | PARTIAL_MATCH_ZIP_CODE si coincide; NO_MATCH si no |
null | Con dato | PARTIAL_MATCH_STREET_ADDRESS si coincide; NO_MATCH si no |
null | null | No hay nada que validar: no es necesario enviar avs_result |
Si hay datos y no envías avs_result (o envías un valor inválido), se toma como NO_MATCH.
avs_result es informativo: no afecta la aprobación de la transacción, que sigue dependiendo de tu status.
Parámetros disponibles
Este endpoint acepta múltiples tipos de body. Seleccioná una variante para ver sus parámetros y ejemplo.
application/jsonBody que enviamos al endpoint de Autorización que nos diste.
Detalle de respuestas
{
"transaction": {
"id": "ctx-200kXoaEJLNzcsvNxY1pmBO7fEx",
"point_type": "POS",
"entry_mode": "MANUAL",
"country_code": "ARG",
"origin": "DOMESTIC",
"source": "ONLINE",
"network": "MASTERCARD",
"cardless_withdrawal_user_id": "example_value",
"cardless_withdrawal_token": "example_value",
"tl_id": "example_value",
"original_transaction_id": "ctx-200kirg6qicg1qHSCbgaStrEHjI",
"local_date_time": "2019-08-24T14:15:22",
"confidence_level": "HIGH",
"original_purchase_id": "ctx-200kirg6qicg1qHSCbgaStrEHjI",
"type": "PURCHASE"
},
"merchant": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"mcc": "example_value",
"address": "example_value",
"name": "example_value",
"terminal_id": "example_value",
"country": "example_value",
"city": "example_value"
},
"card": {
"id": "c-1625519392748E6XZBK",
"product_type": "PREPAID",
"provider": "MASTERCARD",
"last_four": "1573",
"product_subtype": "PREPAID",
"external_id": "ext-id-3IKr3oNhRQ6SoVteRBKEpwxbACY"
},
"installments": {
"quantity": "12",
"credit_type": "NO_PROMOTION",
"grace_period": "0",
"current_installment": "1",
"promotion_type": "MSI_PROMOTION"
},
"auth_user_data": {
"zip_code": "12345",
"street_address": "1 Main St"
},
"user": {
"id": "u-1625758043579BAR6D4"
},
"amount": {
"local": {
"total": "99.49",
"currency": "ARS"
},
"settlement": {
"total": "1.08",
"currency": "USD"
},
"transaction": {
"total": "0.86",
"currency": "EUR"
},
"details": [
{
"type": "BASE",
"currency": "example_value",
"amount": "example_value",
"name": "example_value"
}
]
},
"extra_data": {
"cardholder_verification_method": "FAIL_PROCESSING",
"pin_presence": "ONLINE",
"pin_validation": "VALID",
"cvv_presence": "PRESENT",
"cvv_validation": "MATCHING",
"expiration_date_presence": "PRESENT",
"expiration_date_validation": "EXPIRED",
"function_code": "STANDARD",
"tokenization_wallet_name": "Apple_Pay",
"tokenization_wallet_id": "0",
"cardholder_presence": "CARDHOLDER_PRESENCE_PRESENT",
"card_presence": "PRESENT",
"pin_change_send": "SENT",
"pin_change_result": "APPLIED"
}
}{
"status": "APPROVED",
"message": "string",
"status_detail": "APPROVED",
"balance": {
"total": "982345.12",
"currency": "ARS"
},
"avs_result": "FULL_MATCH"
}