/on-us/v1/transactions/authorize

Autorización

Este endpoint te permite autorizar una transacción que procesamos sin pasar por una bandera

Parámetros disponibles

Header Parameters
AuthorizationString
X-Idempotency-KeyString
Cuerpo de solicitud
application/json
transactionobject6 propiedades
posobject3 propiedades
merchantobject6 propiedades
acquirerobject3 propiedades
installmentsobject3 propiedades
instrumentobject2 propiedades
amountsobject3 propiedades

Detalle de respuestas

Ejemplo de solicitud
{
  "transaction": {
    "type": "REFUND",
    "local_date_time": "2025-09-12T14:15:22",
    "original_transaction_id": "example_value",
    "external_transaction_id": "example_value",
    "system_trace_audit_number": "example_value",
    "retrieval_reference_number": "example_value"
  },
  "pos": {
    "point_type": "POS",
    "entry_mode": "MANUAL",
    "terminal_id": "example_value"
  },
  "merchant": {
    "country": "MEX",
    "address": "example_value",
    "city": "example_value",
    "name": "example_value",
    "id": "example_value",
    "mcc": "example_value"
  },
  "acquirer": {
    "id": "example_value",
    "name": "example_value",
    "country": "example_value"
  },
  "installments": {
    "quantity": 12,
    "type": "ACQUIRER",
    "credit_type": "NO_PROMOTION"
  },
  "instrument": {
    "type": "CARD_ID",
    "id": "crd-1znYO6Hr5MVzcayCCqvA0SL0vTD"
  },
  "amounts": {
    "transaction": {
      "amount": "1000.00",
      "currency": "ARS"
    },
    "settlement": {
      "amount": "1000.00",
      "currency": "ARS"
    },
    "details": [
      {
        "type": "BASE",
        "currency": "ARS",
        "amount": "1000.00",
        "name": "Base 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": "REFUND",
    "local_date_time": "2025-09-12T14:15:22",
    "original_transaction_id": "example_value",
    "external_transaction_id": "example_value",
    "system_trace_audit_number": "example_value",
    "retrieval_reference_number": "example_value"
  },
  "pos": {
    "point_type": "POS",
    "entry_mode": "MANUAL",
    "terminal_id": "example_value"
  },
  "merchant": {
    "country": "MEX",
    "address": "example_value",
    "city": "example_value",
    "name": "example_value",
    "id": "example_value",
    "mcc": "example_value"
  },
  "acquirer": {
    "id": "example_value",
    "name": "example_value",
    "country": "example_value"
  },
  "installments": {
    "quantity": 12,
    "type": "ACQUIRER",
    "credit_type": "NO_PROMOTION"
  },
  "instrument": {
    "type": "CARD_ID",
    "id": "crd-1znYO6Hr5MVzcayCCqvA0SL0vTD"
  },
  "amounts": {
    "transaction": {
      "amount": "1000.00",
      "currency": "ARS"
    },
    "settlement": {
      "amount": "1000.00",
      "currency": "ARS"
    },
    "details": [
      {
        "type": "BASE",
        "currency": "ARS",
        "amount": "1000.00",
        "name": "Base amount"
      }
    ]
  }
}'
Ejemplo de respuesta (200)Resultado de la autorización (aprobada o rechazada)
{
  "data": {
    "id": "ctx-1znYO6Hr5MVzcayCCqvA0SL0vTD",
    "external_id": "external-ctx-123",
    "type": "REFUND",
    "status": "APPROVED",
    "status_detail": "APPROVED",
    "extra_detail": "Rejected due to insufficient funds",
    "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": "1000.00",
          "name": "Base amount"
        }
      ]
    }
  }
}

Pomelo AI

Asistente de inteligencia artificial para consultas sobre la API de Pomelo
¡Hola!¿Cómo puedo ayudarte hoy?