POST
/on-us/v1/transactions/authorizeTransacción
Este endpoint te permite solicitar una transacción que procesamos sin pasar por una bandera. Enviaremos una solicitud para autorizar la transaccion solicitada.
Parámetros disponibles
Header Parameters
AuthorizationStringrequired
X-Idempotency-KeyStringrequired
Cuerpo de solicitud
application/jsontransactionobjectrequired6 propiedades
posobjectrequired3 propiedades
merchantobjectrequired6 propiedades
acquirerobjectrequired3 propiedades
installmentsobject3 propiedades
instrumentobjectrequired2 propiedades
amountsobjectrequired3 propiedades
Detalle de respuestas
Ejemplo de solicitud
{
"transaction": {
"type": "PURCHASE",
"local_date_time": "2025-09-12T14:15:22",
"original_transaction_id": "ctx-1",
"external_transaction_id": "external-ctx-123",
"system_trace_audit_number": "656761",
"retrieval_reference_number": "528294182583"
},
"pos": {
"point_type": "POS",
"entry_mode": "CHIP",
"terminal_id": "TR10000"
},
"merchant": {
"country": "MEX",
"address": "EL SALTO JAL MEX",
"city": "EL SALTO JAL",
"name": "OXXOLOMAS DEL SALTO",
"id": "4102535",
"mcc": "5499"
},
"acquirer": {
"id": "12345",
"name": "Acquirer Name",
"country": "ARG"
},
"installments": {
"quantity": 12,
"type": "ACQUIRER",
"credit_type": "NO_PROMOTION"
},
"instrument": {
"type": "CARD",
"id": "crd-12345678"
},
"amounts": {
"transaction": {
"amount": "1000.00",
"currency": "ARS"
},
"settlement": {
"amount": "1000.00",
"currency": "ARS"
},
"settlement_details": [
{
"type": "GRATUITY",
"currency": "ARS",
"amount": "50.00",
"name": "Gratuity amount"
}
]
}
}Ejemplo de código
curl -X POST "https://api.pomelo.la/on-us/v1/transactions/authorize" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "X-Idempotency-Key: example_value" \
-d '{
"transaction": {
"type": "PURCHASE",
"local_date_time": "2025-09-12T14:15:22",
"original_transaction_id": "ctx-1",
"external_transaction_id": "external-ctx-123",
"system_trace_audit_number": "656761",
"retrieval_reference_number": "528294182583"
},
"pos": {
"point_type": "POS",
"entry_mode": "CHIP",
"terminal_id": "TR10000"
},
"merchant": {
"country": "MEX",
"address": "EL SALTO JAL MEX",
"city": "EL SALTO JAL",
"name": "OXXOLOMAS DEL SALTO",
"id": "4102535",
"mcc": "5499"
},
"acquirer": {
"id": "12345",
"name": "Acquirer Name",
"country": "ARG"
},
"installments": {
"quantity": 12,
"type": "ACQUIRER",
"credit_type": "NO_PROMOTION"
},
"instrument": {
"type": "CARD",
"id": "crd-12345678"
},
"amounts": {
"transaction": {
"amount": "1000.00",
"currency": "ARS"
},
"settlement": {
"amount": "1000.00",
"currency": "ARS"
},
"settlement_details": [
{
"type": "GRATUITY",
"currency": "ARS",
"amount": "50.00",
"name": "Gratuity amount"
}
]
}
}'Ejemplo de respuesta (200)Resultado de la autorización (aprobada o rechazada)
{
"data": {
"id": "ctx-1znYO6Hr5MVzcayCCqvA0SL0vTD",
"external_id": "external-ctx-123",
"type": "PURCHASE",
"status": "APPROVED",
"status_detail": "APPROVED",
"amounts": {
"transaction": {
"amount": "1000.00",
"currency": "ARS"
},
"settlement": {
"amount": "1000.00",
"currency": "ARS"
},
"local_amount": {
"amount": "1000.00",
"currency": "ARS"
},
"details": [
{
"type": "BASE",
"currency": "ARS",
"amount": "950.00",
"name": "Base amount"
},
{
"type": "GRATUITY",
"currency": "ARS",
"amount": "50.00",
"name": "Gratuity amount"
}
]
}
}
}