Servicio de creación de transacciones

El consumo de este servicio es obligatorio en el flujo de pago JavaScript. Además de los parámetros de solicitud de pago REST, también se deben enviar los siguientes parámetros:

Parámetro	Descripción	Formato	Obligatorio
`payment_js`	Debe ser enviado con el valor `true` para habilitar el flujo de pago JavaScript	< 5 A	SÍ
`authenticate`	Identifica el tipo de autenticación 3DS 2.0. `1` = Habilitar el uso de 3DS. Sin embargo, si el servidor 3DS no admite la marca de la tarjeta o falla al realizar la autenticación, el pago se denegará. `2` = Habilitar el uso de 3DS. Sin embargo, si el servidor 3DS no admite la marca de la tarjeta, no autenticará con el servidor 3DS. Si la marca es compatible y la autenticación se niega, el pago se denegará `3` = Habilitar el uso de 3DS. Sin embargo, incluso si la autenticación falla, el pago no se denegará en la autenticación, excepto en casos en los que el usuario cancele o abandone el desafío antes de que se complete.	= 1 N	SÍ
`additional_data`	Datos generales de la transacción.
`exponent`	Número de decimales de la moneda según lo definido en ISO 4217. El valor predeterminado será `2`.	= 1 N	NO
`extra_info`	Información adicional sobre la cuenta proporcionada opcionalmente por el 3DS Requestor.	< 64 AN	NO
`additional_data` `.payer`	Información del titular de la tarjeta.
`email`	Dirección de correo electrónico del titular de la tarjeta. Se recomienda enviar este campo, ya que ayuda en la evaluación de riesgos contribuyendo a una autenticación sin fricciones.	< 256 AN	NO
`name`	Nombre del titular de la tarjeta.	< 45 AN	NO
`additional_data` `.payer` `.phones[]`	Información del teléfono del titular de la tarjeta.
`ddi`	IDD en el teléfono. Se recomienda enviar este campo, ya que ayuda en la evaluación de riesgos contribuyendo a una autenticación sin fricciones.	< 3 N	NO
`ddd`	Código de área del teléfono. Se recomienda enviar este campo, ya que ayuda en la evaluación de riesgos contribuyendo a una autenticación sin fricciones.	< 3 N	NO
`number`	Numero de teléfono. Se recomienda enviar este campo, ya que ayuda en la evaluación de riesgos contribuyendo a una autenticación sin fricciones.	< 12 N	NO
`type`	Tipo de teléfono: `1`: residencial (línea fija) `2`: empresa `6`: móvil Cuando no enviado, se asigna el valor predeterminado: `06` Se recomienda enviar este campo, ya que ayuda en la evaluación de riesgos contribuyendo a una autenticación sin fricciones.	< 12 N	NO
`additional_data` `.billing_data` `.address`	Dirección de Envio.
`city`	Ciudad.	< 50 AN	NO
`country`	Código numérico ISO 3166-1 de tres dígitos para el país.	= 3 N	NO
`street_name`	Nombre de la calle.	< 50 AN	NO
`street_number`	Número de calle.	< 50 AN	NO
`complement`	Complemento de direcciones.	< 50 AN	NO
`zip_code`	CÓDIGO POSTAL.	< 16 AN	NO
`state`	Acrónimo del estado.	< 3 AN	NO
`additional_data` `.shipment` `.address`	Dirección de entrega.
`city`	Ciudad.	< 50 AN	NO
`country`	Código numérico ISO 3166-1 de tres dígitos para el país.	= 3 N	NO
`street_name`	Nombre de la calle.	< 50 AN	NO
`street_number`	Número de calle	< 50 AN	NO
`complement`	Complemento de direcciones.	< 50 AN	NO
`zip_code`	Código Postal..	< 16 AN	NO
`state`	Acrónimo del estado

En respuesta, el siguiente parámetro se devolverá adicionalmente:

Parámetro	Descripción	Formato
payment
`pay_token`	Token asociado al pago JavaScript.	= 66 AN

Para más detalles sobre esta llamada, consulta Pago REST.

Example#

Solicitud:

Para utilizar este ejemplo, no olvides definir la variable. {{url}} con el valor
esitef-homologacao.softwareexpress.com.br

curl
--request POST "https://{{url}}/e-sitef/api/v1/transactions"
--header "Content-Type: application/json"
--header "merchant_id: xxxxxxxx"
--header "merchant_key: xxxxxxxx"
--data-binary
{
    "authenticate": "1",
    "merchant_usn":"12042142155",
    "order_id":"12042142155",
    "installments":"1",
    "installment_type":"4",
    "authorizer_id":"2",
    "amount":"10004",
    "payment_js":"true"
}
--verbose

Respuesta:

{
    "code":"0",
    "message":"OK. Transaction successful.",
    "payment":{
        "status":"NOV",
        "nit":"1234567890123456789012345678901234567890123456789012345678901234",
        "order_id":"12042142155",
        "merchant_usn":"12042142155",
        "amount":"1000",
        "pay_token":"123456789012345678901234567890123456789012345678901234567890123456"
    }
}

Home

Example#