➕ Crear solicitud de pago

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.

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.

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.

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).

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

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.

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.

external_reference

String

Referencia enviada.

payer_name

String

Nombre del pagador.

description

String

Descripción de la solicitud.

first_due_date

Datetime

Fecha de primer vencmiento.

first_total

integrer

Importe a cobrar en el primer vencimiento.

second_due_date

Datetime

Fecha de segundo vencimiento.

second_total

integer

Importe a cobrar en el segundo vencimiento.

barcode

string

Código numérico del código de barra.

rapipago_barcode

String

Url para acceder al codigo de barras

pago_facil_first_due_date_barcode

String

Barcode generado.

pago_facil _second_due_date_barcode

String

Barcode generado.

checkout_url

string

👉 URL para instanciar el Checkout de PAGOS360.

barcode_url

string

Url para acceder al codigo de barras

rapipago_barcode_url

string

Url para acceder al codigo de barras

pago_facil_first_due_date_barcode_url

string

Url para acceder al codigo de barras

pago_facil_second_due_date_barcode_url

string

Url para acceder al codigo de barras

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_u``rl_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.