➕ Crear solicitud de pago

POST /payment-request

Crea una nueva solicitud de pago.

REQUEST

Headers

AtributoTipoRequeridoPatternDescripción
AuthorizationStringSíBearerPodes consultar la sección (API Key) para más información.
Content-TypeStringSíapplication/jsonEl tipo MIME del contenido del cuerpo enviado. Por defecto JSON es Unicode UTF-8. No se debe configurar otro charset.

Body

AtributoTipoRequeridoDescripción
payment_requestobjectSí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:

AtributoTipoRequeridoDescripción
descriptionstringSíDescripción o concepto de la solicitud de pago (hasta 500 caracteres).
first_due_datedateSíFecha de vencimiento de la solicitud de pago. Formato: dd-mm-aaaa.
first_totalfloatSíImporte a cobrar. Formato: 00000000.00 (hasta 8 enteros y 2 decimales, utilizando punto “.” como separador decimal).
payer_namestringSíNombre del destinatario de la solicitud de pago (hasta 255 caracteres).
external_referencestringNoEste 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_datedateNoFecha de segundo vencimiento de la solicitud de pago. Formato: dd-mm-aaaa.
second_totalfloatNoImporte a cobrar pasada la primera fecha de vencimiento. Formato: 00000000.00 (hasta 8 enteros y 2 decimales, utilizando punto “.” como separador decimal).
payer_emailstringNoEmail del destinatario de la solicitud de pago (hasta 255 caracteres).
back_url_successstringNoEn el caso de estar especificado el pagador será redirigido a esta URL ante un pago exitoso (hasta 255 caracteres).
back_url_pendingstringNoEn el caso de estar especificado el pagador será redirigido a esta URL ante un pago pendiente (hasta 255 caracteres).
back_url_rejectedstringNoEn el caso de estar especificado el pagador será redirigido a esta URL ante un pago rechazado (hasta 255 caracteres).
excluded_channelsarray [string]NoTipos 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_brandsarray [string]NoCó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_installmentsarray [int]NoCantidad de cuotas que serán excluidas de las opciones disponibles para el pagador (solo aplica para tarjetas de crédito).
metadataobjectNoObjeto JSON que se puede utilizar para guardar atributos adicionales y poder sincronizar con tus sistemas de backend. PAGOS360 no utiliza este objeto.
itemsarray [object]NoObjeto 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_insightsObjectNoObjeto 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

AtributoTipoRequeridoDescripción
quantityintegerNoCantidad del producto o servicio.
descriptionstringSíDescripción del producto o servicio (hasta 255 caracteres).
amountfloatSíImporte del producto o servicio. Formato: 00000000.00 (hasta 8 enteros y 2 decimales, utilizando punto “.” como separador decimal).

Atributos del objeto risk_insights

AtributoTipoDescripción
sitestringDescripción del sitio web, punto de venta o identificador de la app donde se originó la transacción.
ipstringDirecció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_stringstringCampo User-Agent de la cabecera HTTP.
device_idstringHash identificador del dispositivo (device fingerprint).
user_nationalitystringNacionalidad del usuario, utilizando el código de país de 2 letras definidos en la ISO 3166-1 alpha-2. (Argentina = AR)
user_id_ typestringTipo de documento de identificación del usuario: NATIONAL_ID = Identificaciones nacionales (ej: DNI), PASSPORT = Pasaporte, OTHER = otro tipo de documentespecificado.
user_idstringNúmero de documento de identificación del usuario.
user_full_ namestringNombre y apellido completo del usuario.
user_first_ namestringNombres del usuario.
user_last_ namestringApellidos del usuario.
user_birthdateFecha de nacimiento del usuario en formato DD-MM-AAAA (ej: 01-01-1983).
user_genderstringGé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_emailstringDirección de correo electrónico del usuario.
user_phonestringNúmero de teléfono del usuario.
user_verif_ levelstringNivel 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_ accountstringCuenta bancaria del usuario. Para cuentas de Argentina se debe utilizar CBU/CVU.
user_streetstringDomicilio del usuario: Calle y número.
user_street2stringDomicilio del usuario: Piso, departamento, unidad, barrio, etc.
user_postcodestringDomicilio del usuario: Código postal. Para domicilios de Argentina se debe utilizar formato CPA.
user_citystringDomicilio del usuario: Ciudad o localidad.
user_statestringDomicilio del usuario: Provincia o estado.
user_countrystringDomicilio del usuario: País utilizando el código de 2 letras definidos en la ISO 3166-1 alpha-2. (Argentina = AR)
profile_uidstringIdentificador único asociado al perfil del usuario registrado en tu sitio.
profile_createdtimestampMarca 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_ methodstringMé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_idstringIdentificador de la orden asociada a la transacción.
order_itemsArray [Object]Los ítems describen los bienes o servicios específicos asociados a la transacción.
item_storestringCuando 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_categorystringCategoría a la que pertenece el ítem. Ejemplos: electrónica, indumentaria, etc.
item_is_ intangiblebooleanIndica si el ítem es un servicio intangible o digital (ej: softwares, seguros, consultorías, cursos online, membresías, etc.).
item_idstringIdentificador 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_namestringDescripción generalizada o de alto nivel del ítem. Este valor debe enviarse como texto sin formato (sin markup o valores Unicode).
item_descriptionstringDetalle o descripción del ítem. Este valor debe enviarse como texto sin formato (sin markup o valores Unicode).
item_pricefloatPrecio unitario del ítem.
item_quantityintegerLa cantidad de ítems incluidos en la orden.
billing_namestringNombre o razón social para la factura.
billing_streetstringDomicilio de facturación: Calle y número.
billing_street2stringDomicilio de facturación: Piso, departamento, unidad, barrio, etc.
billing_postcodestringDomicilio de facturación: Código postal. Para domicilios de Argentina se debe utilizar formato CPA.
billing_citystringDomicilio de facturación: Ciudad o localidad.
billing_statestringDomicilio de facturación: Provincia o estado.
billing_countrystringDomicilio de facturación: País utilizando el código de 2 letras definidos en la ISO 3166-1 alpha-2. (Argentina = AR)
shipping_methodstringMétodo de envío o empresa. Ejemplos: Correo Argentino, Andreani, Ocasa, Pickit, PUDO, etc.
shipping_namestringPersona autorizada para recibir la entrega.
shipping_phonestringNúmero de teléfono registrado para la entrega del producto.
shipping_streetstringDomicilio de entrega o prestación del servicio: Calle y número.
shipping_street2stringDomicilio de entrega o prestación del servicio: Piso, departamento, unidad, barrio, etc
shipping_postcodestringDomicilio de entrega o prestación del servicio: Código postal. Para domicilios de Argentina se debe utilizar formato CPA.
shipping_citystringDomicilio de entrega o prestación del servicio: Ciudad o localidad.
shipping_statestringDomicilio de entrega o prestación del servicio: Provincia o estado.
shipping_countrystringDomicilio 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_fieldsobjectConjuntos de campos relevantes en determinados casos de uso o industrias específicas. Pueden ser del tipo string, boolean

HEADERS

Content-Typeapplication/json
El tipo MIME del contenido del cuerpo enviado. Por defecto JSON es Unicode UTF-8. No se debe configurar otro charset.
AuthorizationBearer •••••••
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
Copy

📨 Respuesta

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

AtributoTipoDescripción
idintegerID de solicitud de pago.
typestringTipo de solicitud.
statestringEstado de la solicitud de pago.
created_atdatetimeFecha y hora de creación.
checkout_urlstring👉 URL para instanciar el Checkout de PAGOS360.
barcodestringCódigo numérico del código de barra.
barcode_urlstringURL de la imagen del código de barra utilizado para pagar en las redes de pago en efectivo.
pdf_urlstringURL de cupón de pago en formato pdf.
back_`url _success`StringEn el caso de estar especificado el pagador será redirigido a esta URL ante un pago exitoso.
back__url__pendingStringEn el caso de estar especificado el pagador será redirigido a esta URL ante un pago pendiente.
back__url__rejectedStringEn el caso de estar especificado el pagador será redirigido a esta URL ante un pago rechazado.
excluded_channelsArray [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_installmentsArray [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)
metadataObjectObjeto 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.
itemsArray [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_insightsObjectObjeto 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
Copy
Type to search, ESC to discard
Type to search, ESC to discard
Type to search, ESC to discard
Tabla de Contenido
➕ Crear solicitud de pagoREQUESTHeadersBodyHEADERSPOST Crear Solicitud de PagoExample Request📨 RespuestaExample Response