Link de pago API

Generación de un link de pago.

1. Generar link de pago por medio de API

En la presente documentación se detalla el endpoint para generar links de pagos así como su request y response.

2. Endpoint

POST

https://gateway.atix.com.pe/payment/v1/api/UrlPayment

3. Parámetros en el header (Autenticación)

 Key: 'X-API-KEY' 
 Value: //"Key generada al comercio al momento de su afiliación" 
  
 Key: 'Content-Type' 
 Value: 'application/json' 

4. Request

Se detallan cada uno de los campos que se deben enviar para generar el link de pago (POST)

{ 
  "totalamount": 1.01, // Valor total de la venta.
  "reference":"20240121-1", // Número de referencia del comercio, orden o transacción.
  "reference2":"20240121-1", // Número de referencia interno, sólo visible por el comercio.
  "email": "[e-mail]", // email del tarjetahabiente para que le llegue el link de pago
  "clientip": "172.0.0.99", // Ip de donde salio la petición
  "currency":"PEN", // Tipo de moneda, PEN | USD dependiendo si su cuenta es en soles o dolares.
  "transactiontype":"999", // Indica el tipo de transacción (Siempre debe ir 999).
  "sendmail":"1" // 1 para enviar el link al correo electrónico del tarjetahabiente.
}

5. Diccionario de datos request

Campo	Tipo	Longitud	Requerido	Descripción
totalamount	Money		Si	Monto a procesar
reference	String	30	Si	Referencia única por transacción
reference2	String	200	Si	Referencia opcional
currency	String	10	Si	Moneda formato ISO 4217
email	String	200	Si	Correo electrónico del tarjetahabiente
clientip	String	50	Si	Ip del cliente que realiza la operación
transactiontype	String	3	SI	Indica el tipo de transacción (Para link de pago es 999)
sendmail	String	1	SI	Indica el envío del link por email al tarjetahabiente

6. Response

{ 
    "success": true, 
    "errorcode": "", 
    "errordescription": "", 
    "data": { 
        "UrlPayment": "{{{host}}}/BH4013908", 
        "Tokenid": "BH4013908" 
    } 
}

7. Diccionario de datos response

Campo	Tipo	Longitud	Requerido	Descripción
success	Bool		Si	Si la transacción fue satisfactoria o nó
errorcode	String		Si	Tipo de error en caso de que la transacción no fue satisfactoria
errordescription	String	50	Si	Descripción del error presentado
UrlPayment	String	500	Si	Url a la que se debe hacer redirect al usuario (incluye token único para el pago)
Tokenid	String	250	Si	Token único devuelto por transacción

8. Data de prueba

Caso exitoso

Número	Mes/año	CVV	Código de respuesta
424242424242424242	10/2026	999	00

Caso denegado

Número	Mes/año	CVV	Código de respuesta
5431111111111111	10/2025	999	-99