Autorizar

POST

/api/payments/authorize

Payments

Reserva fondos en la tarjeta del cliente sin realizar el cobro. El dinero queda retenido y no está disponible para el titular, pero aún no se transfiere a su cuenta.

Característica	Detalle
Método	`POST`
¿Requiere datos de tarjeta?	✅ Sí
¿Mueve dinero?	❌ No, solo retiene
Vigencia	7-30 días (según banco emisor)

Casos de uso:

E-commerce: Validar fondos antes de confirmar stock

Hoteles: Retener depósito de garantía al check-in

Servicios: Reservar monto estimado antes del servicio

⚠️ Importante: El campo transactionid es necesario para realizar operaciones posteriores de Capture o Void. Almacénelo de forma segura en su base de datos.

Solicitud

Parámetros de Header

Parámetros del Body application/jsonRequerido

Ejemplos

Respuestas

🟢200Success

application/json

Body

🟠400Bad Request

🟠401Unauthorized

🔴500Internal Server Error

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://sandbox.mypaygateway.io/api/payments/authorize' \
--header 'x-api-key;' \
--header 'Content-Type: application/json' \
--data-raw '{
  "ccnumber": "41111111111111",
  "ccexp": "2129",
  "cvv": "900",
  "amount": 1.00,
  "currency": "USD",
  "orderid": "PROD-TEST",
  "first_name": "Juan",
  "last_name": "Perez",
  "email": "juanperz@test.com"
}'

Ejemplo de Respuesta

200 - Ejemplo

{
    "response": "string",
    "responsetext": "string",
    "authcode": "string",
    "transactionid": "string",
    "avsresponse": "string",
    "cvvresponse": "string",
    "orderid": "string",
    "response_code": "string",
    "emv_auth_response_data": "string",
    "customer_vault_id": "string",
    "kount_score": "string",
    "merchant_advice_code": "string"
}

Modificado en 2026-01-15 21:38:27

Introducción

Capturar