Esta API REST permite a los comercios electrónicos crear una Payment Request para un carrito de compras. La Payment Request generada tiene un código QR asociado, el cuál se utiliza para que el usuario finalice el pago mediante la App MODO o App bancaria.

ℹ️ Nota: asigna un identificador único de transacción (external_intention_id) por cada Payment Request creado.

Autenticación

Para acceder a esta API, se requiere autenticación mediante un token de acceso.

Crear Payment Request

Endpoint

POST {{base_url}}/v2/payment-requests/

Parámetros de la solicitud

Parámetro	Tipo	Requerido	Gateway	Descripción
description	string	✅	Decidir 2.0 Decidir Plus IPG Getnet Line	Descripción de la operación. Máximo de 100 caracteres.
amount	float	✅		Monto de la operación. Un máximo total de 13 caracteres, de los que como máximo 9 caracteres enteros y 3 decimales. El separador decimal es el “.”
currency	string	✅		La moneda utilizada para el precio del producto. En este caso, se utiliza el código 'ARS' que representa el peso Argentino (es el único permitido)
cc_code	string	✅		Identificador que utilizamos para mostrar la financiación disponible a los usuarios al momento de pagar. Listado de condiciones comerciales genéricas
processor_code	string	✅		Identificador que contiene la configuración del gateway de pago que permite que se procese la transacción de forma correcta
external_intention_id	string	✅		ID que identifica a la operación. Es transversal a modo y al gateway. Debe ser un campo unívoco, lo que implica que debe de cambiar por cada Payment Request. Similar al número de pedido u orden dentro de una tienda online. Si usan este mejor aún.
expiration_date	string	❌		La fecha y hora de vencimiento son opcional para la creación de la intención de cobro. En formato ISO 8601 (formato básico YYYY-MM-DDTHH:MM:SS). En caso de que no se envíe el campo, el valor por defecto es 10 minutos.
message	string	❌		Proporciona un medio para que el comerciante incluya un mensaje relevante que necesita ser transmitido junto con la payment request, hasta que se reciba en el webhook correspondiente. Este mensaje se lleva a través de todos los estados del pago.
webhook_notification	string	❌		URL a la que se envía la notificación vía webhook. De no indicarse, se utiliza el valor por defecto configurado en la tienda cuando se dió de alta.
customer	object	❌		Objeto con información del cliente que está realizando la compra en la tienda online.
shipping_address	object	❌		Objeto con información del domicilio de envío de la compra. No aplica para productos/servicios digitales.
items	array	❌		Arreglo con información del carrito de compra del cliente.
establishment_numbers	array	✅	Únicamente Line	Números de establecimiento para el pago

Customer

Atributo	Tipo	Requerido	Descripción
full_name	string	✅	Nombre y apellido
email	string	✅	Mail
identification	string	✅	DNI/CUIL/CUIT
birth_date	string	❌	Fecha de nacimiento. En formato ISO 8601 (formato básico YYYY-MM-DD)
phone	string	❌	Número de celular
id	string	❌	Identificador del cliente en la tienda. Debe ser único e irrepetible
invoice_address	object	❌	Objeto con información del domicilio de facturación del cliente.

Invoice y Shipping Adress

Atributo	Tipo	Requerido	Descripción
state	string	❌	Provincia
city	string	❌	Ciudad
zip_code	string	❌	Código postal
street	string	❌	Calle
number	string	❌	Altura

Items

Atributo	Tipo	Requerido	Descripción
description	string	❌	Descripción del ítem/producto
quantity	integer	❌	Cantidad del producto
unit_price	inte	❌	Precio unitario del producto
image	string	❌	Imágen del producto. Debe ser la url de la imagen del producto.
sku	string	❌	Identificador del producto en la Tienda. Debe ser único e irrepetible
category_name	string	❌	Categoría del producto

Establishment Numbers (únicamente para gateway Line)

Atributo	Tipo	Requerido	Descripción
establishment_number	string	✅	Número de establecimiento
card_issuer	string	✅	Marca de la tarjeta. Posibles valores: VISA, MASTER, NARANJA, AMERICAN_EXPRESS, MAESTRO, CABAL, DINERS_CLUB, CONFIABLE Siempre enviar el valor en mayúscula.
card_type	string	❌	Tipo de tarjeta. Posibles valores: CREDIT, DEBIT Siempre enviar el valor en mayúscula. De no indicarse, admite ambos tipos.

ℹ️ Importante

Restricciones campo expiration_date:

El tiempo mínimo de vencimiento es de 5 minutos, y el máximo de 10 minutos. Cualquier valor distinto a este tiempo resultará en un fallo en la creación de la Payment Request.
Si no se proporciona ningún valor para este campo, se establecerá un tiempo de vencimiento predeterminado de 10 minutos.
El tiempo de vencimiento se cuenta a partir del momento en que se crea la Payment Request, y la expiración se valida al momento del escaneo de la misma, como al momento del pago.

Mínimos para crear payment-requests:

Decidir, Decidir Plus y Line: $30.00
IPG: 0.01usd en ARS
Getnet: $400.00

Ejemplo de cuerpo de solicitud para gateway Decidir 2.0, Decidir Plus, IPG y Getnet.

{
    "description": "Descripción de la operación",
    "amount": 50.00,
    "currency": "ARS",
    "cc_code": "1CSI",
    "processor_code": "P1011",
    "external_intention_id": "123456789",
    "webhook_notification": "https://www.myecommerce.com/notifications/",
    "message": "Este mensaje se traslada desde la intención de pago hasta el webhook",
    "customer": {
        "full_name": "Nombre y Apellido",
        "email": "mail@modo.com.ar",
        "identification": "DNI",
        "birth_date": "YYYY-MM-DD",
        "phone": "+541122334455",
        "id": "1234",
        "invoice_address": {
            "state": "Provincia",
            "city": "Ciudad",
            "zip_code": "Código postal",
            "street": "Calle",
            "number": "Altura"
        }
    },
    "shipping_address": {
        "state": "Provincia",
        "city": "Ciudad",
        "zip_code": "Código postal",
        "street": "Calle",
        "number": "Altura"
    },
    "items": [
        {
            "description": "Descripción del ítem/producto",
            "quantity": 1,
            "image": "https://www.myecommerce.com/image.jpg",
            "category_name": "Categoría del producto",
            "sku": "123456"
        }
    ]
}

Ejemplo de solicitud para gateway Decidir 2.0, Decidir Plus, IPG y Getnet con cURL

curl -X POST 
  https://merchants.preprod.playdigital.com.ar/v2/payment-requests/ 
  -H 'Content-Type: application/json' 
  -H 'User-Agent: <Merchant-Name>' 
  -H 'Authorization: Bearer <token-de-acceso>' 
  -d '{
    "description": "Descripción de la operación",
    "amount": 50.00,
    "currency": "ARS",
    "cc_code": "1CSI",
    "processor_code": "P1011",
    "external_intention_id": "123456789",
    "webhook_notification": "https://www.myecommerce.com/notifications/",
    "message": "Este mensaje se traslada desde la intención de pago hasta el webhook",
    "customer": {
        "full_name": "Nombre y Apellido",
        "email": "mail@modo.com.ar",
        "identification": "DNI",
        "birth_date": "YYYY-MM-DD",
        "phone": "+541122334455",
        "id": "1234",
        "invoice_address": {
            "state": "Provincia",
            "city": "Ciudad",
            "zip_code": "Código postal",
            "street": "Calle",
            "number": "Altura"
        }
    },
    "shipping_address": {
        "state": "Provincia",
        "city": "Ciudad",
        "zip_code": "Código postal",
        "street": "Calle",
        "number": "Altura"
    },
    "items": [
        {
            "description": "Descripción del ítem/producto",
            "quantity": 1,
            "image": "https://www.myecommerce.com/image.jpg",
            "category_name": "Categoría del producto",
            "sku": "123456"
        }
    ]
}'

El valor <Merchant-Name> mostrado en los ejemplos es solo un placeholder. Debe reemplazarse por el nombre real del comercio. En caso de no enviar este header, la solicitud será rechazada como ya lo explicamos acá.

Ejemplo de cuerpo de solicitud para gateway Line

{
    "description": "Descripción de la operación",
    "amount": 50.00,
    "currency": "ARS",
    "cc_code": "3CSI-6CSI-9CSI-12CSI",
    "processor_code": "P1000",
    "external_intention_id": "123456789",
    "webhook_notification": "https://www.myecommerce.com/notifications/",
    "message": "Este mensaje se traslada desde la intención de pago hasta el webhook",
    "establishment_numbers": [
        {
            "establishment_number": "24719411",
            "card_issuer": "VISA",
            "card_type": "CREDIT"
        },
       {
            "establishment_number": "24719411",
            "card_issuer": "MASTER",
            "card_type": "CREDIT"
        }        
    ],
    "customer": {
        "full_name": "Nombre y Apellido",
        "email": "mail@modo.com.ar",
        "identification": "DNI",
        "birth_date": "YYYY-MM-DD",
        "phone": "+541122334455",
        "id": "1234",
        "invoice_address": {
            "state": "Provincia",
            "city": "Ciudad",
            "zip_code": "Código postal",
            "street": "Calle",
            "number": "Altura"
        }
    },
    "shipping_address": {
        "state": "Provincia",
        "city": "Ciudad",
        "zip_code": "Código postal",
        "street": "Calle",
        "number": "Altura"
    },
    "items": [
        {
            "description": "Descripción del ítem/producto",
            "quantity": 1,
            "image": "https://www.myecommerce.com/image.jpg",
            "category_name": "Categoría del producto",
            "sku": "123456"
        }
    ]
}

Ejemplo de solicitud para gateway Line con cURL

curl -X POST 
  https://merchants.preprod.playdigital.com.ar/v2/payment-requests/ 
  -H 'Content-Type: application/json' 
  -H 'User-Agent: <Merchant-Name>' 
  -H 'Authorization: Bearer <token-de-acceso>' 
  -d '{
    "description": "Descripción de la operación",
    "amount": 50.00,
    "currency": "ARS",
    "cc_code": "3CSI-6CSI-9CSI-12CSI",
    "processor_code": "P1000",
    "external_intention_id": "123456789",
    "webhook_notification": "https://www.myecommerce.com/notifications/",
    "message": "Este mensaje se traslada desde la intención de pago hasta el webhook",
    "establishment_numbers": [
        {
            "establishment_number": "24719411",
            "card_issuer": "VISA",
            "card_type": "CREDIT"
        },
        {
            "establishment_number": "24719411",
            "card_issuer": "MASTER",
            "card_type": "CREDIT"
        }        
    ],
    "customer": {
        "full_name": "Nombre y Apellido",
        "email": "mail@modo.com.ar",
        "identification": "DNI",
        "birth_date": "YYYY-MM-DD",
        "phone": "+541122334455",
        "id": "1234",
        "invoice_address": {
            "state": "Provincia",
            "city": "Ciudad",
            "zip_code": "Código postal",
            "street": "Calle",
            "number": "Altura"
        }
    },
    "shipping_address": {
        "state": "Provincia",
        "city": "Ciudad",
        "zip_code": "Código postal",
        "street": "Calle",
        "number": "Altura"
    },
    "items": [
        {
            "description": "Descripción del ítem/producto",
            "quantity": 1,
            "image": "https://www.myecommerce.com/image.jpg",
            "category_name": "Categoría del producto",
            "sku": "123456"
        }
    ]
}'

Respuesta Exitosa gateway Decidir 2.0, Decidir Plus, IPG, Getnet y Line.

Código de estado: 201 Created

Cuerpo de la respuesta:

{
    "id": "49e8ed80-903c-4110-bab2-1c4a31ee8582",
    "qr": "example.qr",
    "deeplink": "https://www.preprod.modo.com.ar/pagar/",
    "created_at": "2025-04-25T06:50:33.627Z",
    "expiration_at": 600000,
    "expiration_date": "2025-04-25T07:00:33.627Z",
    "sub_payments": null,
    "best_installment": {
        "quantity": null,
        "has_interest": null
    }
}

Respuestas de Error:

400 Bad Request: Si faltan parámetros obligatorios o los parámetros son inválidos.
401 Unauthorized: Si las credenciales proporcionadas son incorrectas.
500 Internal Server Error: Si hay un error interno en el servidor

Creación de Payment Request

Últ. fecha de actualización: 18-03-26

Cargando