➕ Crear solicitud de pago

POST /payment-request

Crea una nueva solicitud de pago.

REQUEST

Headers

Atributo	Tipo	Requerido	Pattern	Descripción
`Authorization`	String	Sí	`Bearer`	Podes consultar la sección (API Key) para más información.
`Content-Type`	String	Sí	`application/json`	El tipo MIME del contenido del cuerpo enviado. Por defecto JSON es Unicode UTF-8. No se debe configurar otro charset.

Body

Atributo	Tipo	Requerido	Descripción
`payment_request`	object	Sí	Es la entidad que individualiza la intención de recibir un pago a través de PAGOS360 y es necesaria para ejecutar una transacción de pago. Mas info.

Atributos del objeto payment_request:

Atributo	Tipo	Requerido	Descripción
`description`	string	Sí	Descripción o concepto de la solicitud de pago (hasta 500 caracteres).
`first_due_date`	date	Sí	Fecha de vencimiento de la solicitud de pago. Formato: `dd-mm-aaaa`.
`first_total`	float	Sí	Importe a cobrar. Formato: `00000000.00` (hasta 8 enteros y 2 decimales, utilizando punto “.” como separador decimal).
`payer_name`	string	Sí	Nombre del destinatario de la solicitud de pago (hasta 255 caracteres).
`external_reference`	string	No	Este atributo se puede utilizar como referencia para identificar la solicitud de pago y sincronizar con tus sistemas de backend el origen de la operación. Algunos valores comúnmente utilizados son: ID de cliente, DNI, CUIT, ID de venta o Nro. de factura entre otros. (hasta 255 caracteres).
`second_due_date`	date	No	Fecha de segundo vencimiento de la solicitud de pago. Formato: `dd-mm-aaaa`.
`second_total`	float	No	Importe a cobrar pasada la primera fecha de vencimiento. Formato: `00000000.00` (hasta 8 enteros y 2 decimales, utilizando punto “.” como separador decimal).
`payer_email`	string	No	Email del destinatario de la solicitud de pago (hasta 255 caracteres).
`back_url_success`	string	No	En el caso de estar especificado el pagador será redirigido a esta URL ante un pago exitoso (hasta 255 caracteres).
`back_url_pending`	string	No	En el caso de estar especificado el pagador será redirigido a esta URL ante un pago pendiente (hasta 255 caracteres).
`back_url_rejected`	string	No	En el caso de estar especificado el pagador será redirigido a esta URL ante un pago rechazado (hasta 255 caracteres).
`excluded_channels`	array [string]	No	Tipos de medios de pago que serán omitidos de las opciones al pagador. Valores posibles: `credit_card`, `debit_card`, `banelco_pmc`, `link_pagos` , `DEBIN`, `wire_transfer` y `non_banking`.
`excluded_card_brands`	array [string]	No	Códigos de las tarjetas que serán omitidas de las opciones al pagador. Los valores aceptados pueden ser consultados en el atributo `code` del endpoint consultar planes y cuotas (solo aplica para tarjetas de crédito).
`excluded_installments`	array [int]	No	Cantidad de cuotas que serán excluidas de las opciones disponibles para el pagador (solo aplica para tarjetas de crédito).
`metadata`	object	No	Objeto JSON que se puede utilizar para guardar atributos adicionales y poder sincronizar con tus sistemas de backend. PAGOS360 no utiliza este objeto.
`items`	array [object]	No	Objeto JSON que se puede utilizar para ampliar la descripción de la solicitud de pago. Permite enviar una lista de productos o servicios a ser pagados. Esta información es utilizada en el detalle del comprobante de pago. Ver a continuación sus atributos.
risk_insights	Object	No	Objeto JSON que se puede utilizar para enviar datos adicionales que ayudan a predecir la probabilidad de que un pago sea fraudulento. Todos los campos a continuación, son opcionales, pero cuanto más se completen, más precisos serán nuestros resultados.

Atributos del objeto items

Atributo	Tipo	Requerido	Descripción
`quantity`	integer	No	Cantidad del producto o servicio.
`description`	string	Sí	Descripción del producto o servicio (hasta 255 caracteres).
`amount`	float	Sí	Importe del producto o servicio. Formato: 00000000.00 (hasta 8 enteros y 2 decimales, utilizando punto “.” como separador decimal).

Atributos del objeto risk_insights

Atributo	Tipo	Descripción
site	string	Descripción del sitio web, punto de venta o identificador de la app donde se originó la transacción.
ip	string	Dirección IP del usuario que originó la transacción. Puede enviar una dirección IPv4 o IPv6. El campo distingue entre mayúsculas y minúsculas. Ej: 1.1.1.1 o 2001:db8:3333:4444:5555:6666:7777:8888 (nunca debe ser una dirección IP privada o reservada, del tipo 10.x.x.x o 192.168.x.x).
ua_string	string	Campo User-Agent de la cabecera HTTP.
device_id	string	Hash identificador del dispositivo (device fingerprint).
user_nationality	string	Nacionalidad del usuario, utilizando el código de país de 2 letras definidos en la ISO 3166-1 alpha-2. (Argentina = AR)
user_id_ type	string	Tipo de documento de identificación del usuario: NATIONAL_ID = Identificaciones nacionales (ej: DNI), PASSPORT = Pasaporte, OTHER = otro tipo de documentespecificado.
user_id	string	Número de documento de identificación del usuario.
user_full_ name	string	Nombre y apellido completo del usuario.
user_first_ name	string	Nombres del usuario.
user_last_ name	string	Apellidos del usuario.
user_birth	date	Fecha de nacimiento del usuario en formato DD-MM-AAAA (ej: 01-01-1983).
user_gender	string	Género del usuario: M = Masculino, F = Femenino, X = comprende a la autopercepción de género con la que pudiera identificarse una persona quse sienta comprendida en el binomio masculino/femenino.
user_email	string	Dirección de correo electrónico del usuario.
user_phone	string	Número de teléfono del usuario.
user_verif_ level	string	Nivel de validación de los datos identificativos del usuario (si se realizan múltiples validaciones indicar la de mayor confianza): NA se realizó ninguna verificación de los datos proporcionados por el usuario, EMAIL = se verificó que la dirección de correo electrónico es válida y es confiable, PHONE = se verificó que el número de teléfono es válido y es confiable, ADDRESS = se verificó que el domicilio de entrega es válido y es confiable, DOC_ID = se verificó que el documento de identificación es válido y es confiable, GOV_ CHECK = se verificó contra una base de datos gubernamental (ej: institutos electorales, registros de población, migraciones, etc.) que el documento de identificación es válido y es confiable, BIOMETRIC = se verificó que la foto en el documento de identificación coincide con una foto selfie o video del usuario, LIVENESS = el usuario superó un desafío biométrico aleatorio de prueba de vida, OTHER = otro nivel de validacióespecificado.
user_bank_ account	string	Cuenta bancaria del usuario. Para cuentas de Argentina se debe utilizar CBU/CVU.
user_street	string	Domicilio del usuario: Calle y número.
user_street2	string	Domicilio del usuario: Piso, departamento, unidad, barrio, etc.
user_postcode	string	Domicilio del usuario: Código postal. Para domicilios de Argentina se debe utilizar formato CPA.
user_city	string	Domicilio del usuario: Ciudad o localidad.
user_state	string	Domicilio del usuario: Provincia o estado.
user_country	string	Domicilio del usuario: País utilizando el código de 2 letras definidos en la ISO 3166-1 alpha-2. (Argentina = AR)
profile_uid	string	Identificador único asociado al perfil del usuario registrado en tu sitio.
profile_created	timestamp	Marca de tiempo en que el usuario se registró por primera vez en tu sitio, utilizando el formato de hora UNIX y la zona horaria UTC, sin milisegundos. Ejemplo: 1673302661. Referencia: epoch converter.
profile_auth_ method	string	Método de autenticación del usuario en tu sitio: USR_DATA = si se utilizan datos personales para acceder (ej: email + DNI), SVC_ DATA = si se utilizan datos vinculados a un servicio para acceder (ej: nro. de cliente + nro. de factura, unidad de facturación, etc.), PWD = si se utiliza una contraseña o combinación de usuario y contraseña, OTP = si se envía por email o sms un código de un solo uso para acceder, MFA = si se requiere un segundo factor de autenticación para acceder (ej: uso de token virtual o físico), OTHER = otro método de autenticacióespecificado.
order_id	string	Identificador de la orden asociada a la transacción.
order_items	Array [Object]	Los ítems describen los bienes o servicios específicos asociados a la transacción.
item_store	string	Cuando el usuario pueden comprar en un mismo sitio a diferentes vendedores, este atributo identifica al vendedor o tienda quofrece el ítem. Ejemplo: Electrodomésticos ACME.
item_category	string	Categoría a la que pertenece el ítem. Ejemplos: electrónica, indumentaria, etc.
item_is_ intangible	boolean	Indica si el ítem es un servicio intangible o digital (ej: softwares, seguros, consultorías, cursos online, membresías, etc.).
item_id	string	Identificador del ítem. Por lo general código SKU si es un producto, o número de contrato si es un servicio. Este valor debe enviarse como texto sin formato (sin markup o valores Unicode).
item_name	string	Descripción generalizada o de alto nivel del ítem. Este valor debe enviarse como texto sin formato (sin markup o valores Unicode).
item_description	string	Detalle o descripción del ítem. Este valor debe enviarse como texto sin formato (sin markup o valores Unicode).
item_price	float	Precio unitario del ítem.
item_quantity	integer	La cantidad de ítems incluidos en la orden.
billing_name	string	Nombre o razón social para la factura.
billing_street	string	Domicilio de facturación: Calle y número.
billing_street2	string	Domicilio de facturación: Piso, departamento, unidad, barrio, etc.
billing_postcode	string	Domicilio de facturación: Código postal. Para domicilios de Argentina se debe utilizar formato CPA.
billing_city	string	Domicilio de facturación: Ciudad o localidad.
billing_state	string	Domicilio de facturación: Provincia o estado.
billing_country	string	Domicilio de facturación: País utilizando el código de 2 letras definidos en la ISO 3166-1 alpha-2. (Argentina = AR)
shipping_method	string	Método de envío o empresa. Ejemplos: Correo Argentino, Andreani, Ocasa, Pickit, PUDO, etc.
shipping_name	string	Persona autorizada para recibir la entrega.
shipping_phone	string	Número de teléfono registrado para la entrega del producto.
shipping_street	string	Domicilio de entrega o prestación del servicio: Calle y número.
shipping_street2	string	Domicilio de entrega o prestación del servicio: Piso, departamento, unidad, barrio, etc
shipping_postcode	string	Domicilio de entrega o prestación del servicio: Código postal. Para domicilios de Argentina se debe utilizar formato CPA.
shipping_city	string	Domicilio de entrega o prestación del servicio: Ciudad o localidad.
shipping_state	string	Domicilio de entrega o prestación del servicio: Provincia o estado.
shipping_country	string	Domicilio de entrega o prestación del servicio: País utilizando el código de 2 letras definidos en la ISO 3166-1 alpha-2. (Argentina = AR)
custom_fields	object	Conjuntos de campos relevantes en determinados casos de uso o industrias específicas. Pueden ser del tipo string, boolean

HEADERS

Content-Type	application/json
	El tipo MIME del contenido del cuerpo enviado. Por defecto JSON es Unicode UTF-8. No se debe configurar otro charset.
Authorization	Bearer •••••••
	Puede consultar la sección API Key para más información.

POST Crear Solicitud de Pago

https://api.sandbox.pagos360.com/payment-request

Example Request

Ejemplo en cURL
    
 
curl -X POST 'https://api.pagos360.com/payment-request'-H 'Content-Type: application/json'-H 'Authorization: Bearer {api_key}'--data-raw '{  "payment_request": {    "description": "concepto_del_pago",    "first_due_date": "25-01-2020",    "first_total": 200.99,    "payer_name": "nombre_pagador"  }}'
Copy

📨 Respuesta

Una respuesta exitosa incluirá los mismos atributos enviados por parámetro al crear la solicitud de pago y adicionalmente los siguientes:

Atributo	Tipo	Descripción
`id`	integer	ID de solicitud de pago.
`type`	string	Tipo de solicitud.
`state`	string	Estado de la solicitud de pago.
`created_at`	datetime	Fecha y hora de creación.
`checkout_url`	string	👉 URL para instanciar el Checkout de PAGOS360.
`barcode`	string	Código numérico del código de barra.
`barcode_url`	string	URL de la imagen del código de barra utilizado para pagar en las redes de pago en efectivo.
`pdf_url`	string	URL de cupón de pago en formato pdf.
`back_``url `_`success`	String	En el caso de estar especificado el pagador será redirigido a esta URL ante un pago exitoso.
`back_`_`url_`_`pending`	String	En el caso de estar especificado el pagador será redirigido a esta URL ante un pago pendiente.
`back_`_`url_`_`rejected`	String	En el caso de estar especificado el pagador será redirigido a esta URL ante un pago rechazado.
`excluded_channels`	Array [String]	Tipos de medios de pago que serán omitidos de las opciones al pagador. Valores posibles: `credit_card, credit_card_agro`, `debit_card`, `banelco_pmc`, `link_pagos`, `DEBIN`, `wire_transfer,` `non_banking` y `QR`. [Mas info](Mas info).
`excluded_installments`	Array [Int]	Número de las cuotas que serán omitidas de las opciones al pagador (Solo aplica para el medio de pago Tarjeta de Crédito).
`excluded_`_`card``brands`	Array [String]	Códigos de las tarjetas que serán omitidas de las opciones al pagador. Valores posibles: campo `code` del endpoint Obtener Planes y Cuotas (Solo aplica para el medio de pago Tarjeta de Crédito). [Ver más](Ver más)
`metadata`	Object	Objeto JSON que se puede utilizar para guardar atributos adicionales en la solicitud de pago y poder sincronizar con tus sistemas de backend. Pagos360.com no utiliza este objeto.
`items`	Array [Object]	Objeto JSON que se puede utilizar para listar todos los productos o servicios asociados a la solicitud de pago, para que sean incluidos como un detalle del comprobante de pago.
`risk_insights`	Object	Objeto JSON que se puede utilizar para enviar datos adicionales que ayudan a predecir la probabilidad de que un pago sea fraudulento. Todos los campos a continuación, son opcionales, pero cuanto más se completen, más precisos serán
`nuestros resultados.`

Example Response

JSON de ejemplo
    
{  "id": 35,  "type": "payment_request",  "state": "pending",  "created_at": "2019-02-22T15:20:49-03:00",  "payer_name": "nombre_pagador",  "description": "concepto_del_pago",  "first_due_date": "2020-01-25T00:00:00-03:00",  "first_total": 200.99,  "checkout_url": "https://checkout.pagos360.com/payment-request/9455caf6-36ce-11e9-96fd-fb95450d3057",  "barcode": "29680000002000000000350002000019138000000004",  "barcode_url": "https://api.pagos360.com/payment-request/barcode/9455caf6-36ce-11e9-96fd-fb95450d3057",  "pdf_url": "https://api.pagos360.com/payment-request/pdf/9455caf6-36ce-11e9-96fd-fb95450d3057",  "rapipago_barcode": "11100081404112211100002558270080000023349000000003",  "rapipago_barcode_url": "https://api.pagos360.com/payment-request/rapipago-barcode/b7d0f8d4-70b3-11ed-b40b-3887d5d88a6a"}
Copy

Última actualización el