--- title: "Crear un nuevo pago - Argentina, Brasil, Chile, Ecuador, México y Perú" method: POST path: "/payment/new-2" --- # Crear un nuevo pago - Argentina, Brasil, Chile, Ecuador, México y Perú `POST /payment/new-2` ## Request - Base URL: `https://sandbox.prontopaga.com/api` - URL: `https://sandbox.prontopaga.com/api/payment/new-2` - Auth: HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) ## Request body - object - `currency` string, required: Código ISO de la moneda: **ARS/CLP/MXN/USD/PEN**. - `country` string, required: Código del país: **AR/CL/MX/EC/PE**. - `amount` string, int32, required: Monto de la transacción
⚠️En **Chile** solo se aceptan montos enteros. Mientras que en **Argentina**, **Perú**, **México** y **Ecuador** se permite el uso de montos con decimales.

**Excepción:** En **Perú**, los pagos con **código de pago** no permiten montos con decimales. - `clientName` string, required: Nombre y apellido del cliente - `clientEmail` string, required: Correo electrónico del cliente.
- `clientPhone` string, required: Número de teléfono del cliente - `clientDocumentType` string:
⚠️Requerido para Perú y México.
Es el tipo de documento de identidad. El código para Perú puede ser:
**DN:** DNI
**CE:** Carné de extranjería
**PP:** Pasaporte

El código para México puede ser:
**INE**
**CURP**
**RFC**
**Pasaporte**

En Argentina, Brasil, Chile y Ecuador, este tipo de documento no es requerido. - `clientDocument` string, required: Número del documento de identidad del cliente.
- `paymentMethod` string, required: Método de pago. Consultar las tablas de **Métodos por país** de arriba. - `bankCode` string: Para una solicitud a un **banco específico (Direct Banks) en Chile**.
Aquí debes colocar el valor del campo `code` obtenido en el endpoint de [Lista de códigos bancarios](https://docs.prontopaga.com/reference/bank-codes). **Brasil** Este campo es requerido para pagos con Pix en Brasil con cuenta bancaria registrada. Debes colocar el valor del campo `bankCode` obtenido de la [Lista de códigos bancarios](https://docs.prontopaga.com/update/docs/bankcodes-payins-brazil). - `urlConfirmation` string, required: Webhook. Conoce más información en este [artículo](https://docs.prontopaga.com/v2.0/docs/webhooks#/). - `urlFinal` string, required: URL de redirección después de que el pago sea completado - `urlRejected` string, required: URL de redirección en caso de que la transacción sea rechazada - `order` string, int32, required: Identificador del pago a asociar. Debe ser único y no repetitivo - `theme` string: Para personalizar el formulario de pago (configuración válida para los paymentMethod: ar_chk_card_payment, ar_qr_payment, pe_qr_payment y pe_card_payment, mercadopagoqr_payment, mach_payment, yape_oneshot_payment, yape_cof_payment, bemovil_payment): 
"theme\": \"[{\\\"bgColor\\\": \\\"transparent\\\", \\\"mode\\\": \\\"dark\\\", \\\"logo\\\": \\\"hide\\\", \\\"type\\\": \\\"default\\\"}]"

Para recibir el código QR directamente en la respuesta (⚠️ configuración válida únicamente para el paymentMethod: pe_qr_payment y br_pix_payment): 
"theme\": \"{\\\"type\\\":\\\"qr\\"}"
- `sign` string, required: La firma de los parámetros es única para cada transacción. Conoce cómo firmar en este [artículo](https://docs.prontopaga.com/docs/sign-transactions#/). - `wallet_uid` string: ⚠️Requerido solamente para los servicios de **Perú-Yape On File**. Es el identificador único (UID) de la afiliación de la wallet del cliente. - `qr_only` string: Para personalizar el QR *payment template* en **Chile** (configuración válida para el paymentMethod: mach_payment). Valores posibles: **true** | **false** - `accountType` string: Este parámetro es obligatorio para pagos con Pix en Brasil con cuentas bancarias registradas. Estos son los posibles tipos de cuentas que se pueden enviar en el parámetro `accountType` para pagos con cuenta registrada con Pix en Brasil: * `payment` * `checking` * `salary` * `savings` - `branchCode` string: Código de 4 dígitos que identifica la sucursal del banco asociada a la cuenta. Este campo es requerido para pagos con Pix en Brasil con cuenta bancaria registrada. - `accountNumber` string: Número de cuenta del usuario. Este campo es requerido para pagos con Pix en Brasil con cuenta bancaria registrada. - `city` string: Nombre de la ciudad del usuario. Este campo es requerido para pagos con Pix en Brasil con cuenta bancaria registrada. - `codePostal` string: Código postal del usuario. Este campo es requerido para pagos con Pix en Brasil con cuenta bancaria registrada. - `addressLine1` string: Dirección del domicilio del usuario. Este campo es requerido para pagos con Pix en Brasil con cuenta bancaria registrada. - `ttl_minutes` string: Tiempo de expiración del pago: de 15 a 1440 minutos. Este campo es requerido para pagos con Transferencia SPEI en México. ## Response `200` ## Other responses - `201`: Created - `400`: Bad Request - `401`: Unauthorized - `404`: Not Found ## Changes - **2026-11-03** `3f31015a00cf`: 1 info - endpoint added [Operation history](https://skmtc.dev/prontopaga/apis/prontopaga-api/changes/payment/new-2/post.md) --- [API](https://skmtc.dev/prontopaga/apis/prontopaga-api.md) - [All operations](https://skmtc.dev/prontopaga/apis/prontopaga-api/llms.txt) - [OpenAPI document](https://skmtc.dev/prontopaga/apis/prontopaga-api/revisions/3f31015a00cf?raw)