Web Service Charge/CreatePayment
La operación Charge/CreatePayment es un Web Service de la API REST.
Permite realizar diversas operaciones:
Crear una transacción a partir de una tarjeta nueva
Puede crear transacciones a partir de una tarjeta, junto con el formulario incrustado.
En ese caso, el Web Service REST Charge/CreatePayment le devolverá un formToken (token de formulario) que deberá utilizar con nuestro formulario JavaScript.
Para consultar la documentación de referencia de la respuesta que contiene el formToken, consulte: Charge/PaymentForm
Una vez que el pago se ha realizado, la transacción recientemente creada se encuentra en el objeto Payment explicado aquí
Crear una transacción a partir de un token.
De igual forma, puede crear una transacción a partir de un medio de pago previamente registrado (token de pago o simplemente token).
Para más información, consulte: Pago por token.
Para consultar la documentación de referencia de la respuesta, entre a Payment.
Si tiene la certificación PCI DSS
Si tiene la certificación PCI DSS, puede transmitir los datos confidenciales directamente al Web Service (como el número de tarjeta).
Desde un punto de vista técnico:
Para más información, comuníquese con su representante de ventas, quien le ayudará a comprobar su elegibilidad para esta opción.
Desde un punto de vista técnico:
Para más información, consulte nuestra página sobre el uso del Web Service REST Charge/CreatePayment en modo PCI DSS.
Parámetros de la solicitud
El Web Service Charge/CreatePayment REST admite los siguientes parámetros:
amount
Monto del pago en su fracción monetaria más pequeña (el centavo para el peso argentino).
Ejemplo: 30050 para 300,50 ARS.
Formato
contrib
Nombre de la solución de e-comercio utilizada en el sitio web comercial y su número de versión.
Formato
currency
Moneda del pago. Código alfabético un mayúsculas según ISO 4217 alpha-3.
Ejemplo: "ARS" por el peso argentino.
Formato
Valores posibles
Los valores posibles son:
Moneda | CODIFICACIÓN ISO 4217 | Unidad fraccionaria |
---|---|---|
Peso argentino (032) | ARS | 2 |
Dólar estadounidense (840) | USD | 2 |
ipnTargetUrl
Puede sobrescribir la URL de notificación instantánea (también llamada IPN) en el formulario si utiliza una única tienda para diferentes canales de venta, diferentes tipos de pago, diferentes idiomas, etc.
Formato
orderId
Referencia de pedido definida por el vendedor. No admite los caracteres UTF-8.
Formato
metadata
Valores personalizados adjuntos a la transacción, en formato json.
Ejemplo de llamada
Por ejemplo, para transmitir un valor personalizado, agregue a su solicitud:
{ "metadata": { "MyValueKey": "1234" } }
Este valor se devolverá en el objeto de transacción recién creado.
También puede utilizar los metadatos " orderInfo ", " orderInfo2 " y " orderInfo3 " para transmitir la información adicional sobre el pedido.
Estos datos se muestran en el
Formato
fingerPrintId
Este campo lo utilizan los vendedores que implementan el analizador de riesgos en su página de pago. Permite transmitir el identificador de la sesión (o fingerPrint Id) a la plataforma de pago para finalizar el análisis de riesgo.
Los analizadores compatibles son:
- NOTO
- Cybersource
- MonitorPlus
- ClearSale
Puede contener mayúsculas, minúsculas, números o guiones ([AZ] [az], 0-9, _, -).
Formato
formAction
formAction le permite definir el tipo de comportamiento que desea al crear la transacción.
Formato
Valores posibles
Los valores posibles son:
VALOR | Descripción |
---|---|
PAYMENT | Creación de una transacción simple. Comportamiento predeterminado. |
REGISTER_PAY | Creación de un token de los medios de pago al mismo tiempo que la transacción. No permite crear un token asociado a un IBAN. |
ASK_REGISTER_PAY | Añade una casilla de verificación al formulario para la creación de un token. No permite crear un token asociado a un IBAN. |
SILENT | Transacción iniciada por el vendedor sin la presencia del comprador. Realiza un pago por token sin pasar por el formulario incrustado. |
CUSTOMER_WALLET | Añade una casilla de verificación al formulario para asociar la tarjeta al wallet. El campo customer.reference es obligatorio para este caso de uso Consulte el capítulo la guía de integración para obtener más información. |
null | Si el valor es nulo o no definido, se aplica PAYMENT. |
PAYMENT:
El Web Service devuelve un objeto.
Es el comportamiento predeterminado. La llamada a Charge/CreatePayment crea una transacción sin realizar ninguna operación adicional.
REGISTER_PAY:
El Web Service devuelve un objeto.
Se crea un token del medio de pago al mismo tiempo que la transacción. Este token le permite crear transacciones en un solo clic. El token recién creado se indica en la propiedad paymentMethodToken. Para más información, consulte el artículo sobre Creación y uso de token.
ASK_REGISTER_PAY:
El Web Service devuelve un objeto.
Este parámetro permite agregar una casilla de verificación al formulario de pago, preguntándole al comprador si desea registrar su tarjeta.
Accion del comprador | Descripción |
---|---|
La casilla está marcada | Guarda un token de tarjeta (como formAction=REGISTER_PAY). |
La casilla no está marcada | el token no ha sido creado (como formAction=PAYMENT). Comportamiento predeterminado. |
Para más información, consulte el artículo sobre Creación y uso de token.
CUSTOMER_WALLET:
El Web Service devuelve un objeto.
Este parámetro permite agregar una casilla de verificación al formulario de pago, preguntándole al comprador si desea registrar su tarjeta en su wallet. Requiere la referencia del comprador customer.reference.
Accion del comprador | Descripción |
---|---|
La casilla está marcada | Añadir una tarjeta al wallet. |
La casilla no está marcada | Comportamiento por defecto. La tarjeta no se añade al monedero. |
SILENT: SILENT: Se reserva para las transacciones iniciadas por el vendedor sin la presencia del titular, especialmente para pagos recurrentes cuando la recurrencia es gestionada por el vendedor.
En el área de aplicación de la DSP2, la autentificación del titular es obligatoria cuando el titular está presente. Por lo tanto, el modo SILENT se reserva para aquellos casos en que el titular está ausente o para los vendedores que se encuentren fuera del área de la DSP2.
En el área de aplicación de la DSP2, se ignora el campo strongAuthentication y no se realiza autentificación alguna del titular.
El Web Service devuelve directamente una transacción en vez de un formToken durante un pago por token. Por lo tanto, la transacción se realiza de servidor a servidor.
paymentMethodToken
Token asociado a un medio de pago.
Formato
strongAuthentication
strongAuthentication permite indicar la preferencia del vendedor respecto a la autentificación fuerte del comprador.
Con 3DS2 no es posible deshabilitar 3DS. El vendedor debe pedir una exención en su solicitud de pago (se denomina "preferencia del vendedor").
En ese caso, si el emisor acepta la solicitud, el comprador no tendrá que autentificarse (sin challenge), pero el vendedor asume la responsabilidad en caso de impago (no hay transferencia de responsabilidad al emisor).
En todos los casos, es el banco emisor el que determina si es necesario interactuar con el comprador (challenge).
Se requerirá siempre una autentificación fuerte al registrar una tarjeta, cualquiera que sea la preferencia del vendedor.
Valores posibles
Los valores posibles son:
VALOR | Descripción 3DS2 |
---|---|
ENABLED | Obsoleta. Este valor se interpretará como CHALLENGE_REQUESTED. |
DISABLED | Permite solicitar una autentificación sin interacción (frictionless). Necesita la opción "Frictionless 3DS2". Si la tienda no tiene la opción "Frictionless 3DS2", la elección de preferencia se delega al emisor de la tarjeta (No Preference). |
CHALLENGE_REQUESTED | Permite solicitar una autentificación fuerte para la transacción. |
CHALLENGE_MANDATE | Permite indicar que, por razones reglamentarias, se requiere una autentificación fuerte para la transacción. |
NO_PREFERENCE | Permite indicar al DS que el vendedor no tiene preferencia. Si el emisor decide realizar una autentificación sin interacción (frictionless), el pago será garantizado. |
AUTO | Se delega la elección de la preferencia al emisor de la tarjeta (No Preference). |
Formato
acquirerTransientData
Permite la transmisión de información específica a determinados adquirentes/redes.
Restringir los códigos BIN aceptados
Para limitar las tarjetas de pago aceptadas según su código BIN, se requiere el formato siguiente:
{"MULTI":{"bins": ["bin1","bin2","bin3"]}}
Nota : Admite códigos BIN de 6 u 8 dígitos.
Ejemplo: .
Códigos BIN6 cifras: 4012 34XX XXXX XXXX;
Códigos BIN8 cifras: 4000 1234 XXXX XXXX.
Formato
customer.reference
Identificador del comprador en el sitio web comercial.
Obligatorio si vads_cust_status está establecido en PRIORITY.
En ese caso, la referencia del comprador se utiliza como identificador del wallet.
Formato
customer.email
E-mail del comprador.
Cuando desee crear un token del medio de pago (definiendo el valor de formAction en REGISTER_PAY o ASK_REGISTER_PAY ), la dirección de e-mail no se vuelve obligatoria Sin embargo, el comprador deberá indicarlo en el formulario.
Formato
address
Camino: customer.billingDetails.address
Dirección de facturación.
Atención: Los caracteres > y < no están permitidos.
Formato
address2
Camino: customer.billingDetails.address2
Información adicional sobre la dirección de facturación.
Atención: Los caracteres > y < no están permitidos.
Formato
category
Camino: customer.billingDetails.category
Tipo de cliente.
Formato
Valores posibles
Valores | Descripción |
---|---|
PRIVATE | Cliente de tipo Particular |
COMPANY | Cliente de tipo Empresa |
cellPhoneNumber
Camino: customer.billingDetails.cellPhoneNumber
Teléfono móvil del comprador.
Acepta todos los formatos:
Ejemplos:
- 0623456789
- +33623456789
- 0033623456789
- (+34) 824 65 43 21
- 87 77 12 34
Formato
city
Camino: customer.billingDetails.city
Ciudad de facturación.
Formato
country
Camino: customer.billingDetails.country
País del comprador (en letras mayúsculas, según la norma ISO 3166-1 alfa-2).
Formato
Valores posibles
Ejemplos de valores posibles:
País | Código |
---|---|
Argentina | AR |
Brasil | BR |
Colombia | CO |
COSTA RICA | CR |
ECUADOR | EC |
GUATEMALA | GT |
MÉXICO | MX |
NICARAGUA | NI |
PERÚ | PE |
SALVADOR | SV |
ESTADOS UNIDOS DE AMÉRICA | US |
URUGUAY | UY |
district
Camino: customer.billingDetails.district
Barrio de la dirección de facturación.
Formato
firstName
Camino: customer.billingDetails.firstName
Nombre del comprador.
Formato
identityCode
Camino: customer.billingDetails.identityCode
Identificación nacional. Identifica de manera única a cada ciudadano en un país.
Formato
identityType
Camino: customer.billingDetails.identityType
Tipo del documento de identidad.
Valores posibles:
País | TIPO | DESCRIPCIÓN |
---|---|---|
ARGENTINA | DNI | Documento Nacional de Identidad |
BRASIL | CNPJ | Cadastro Nacional da Pessoa Jurídica |
CPF | Cadastro de Pessoas Físicas | |
COLOMBIA | CC | Cédula de ciudadania |
TI | Tarjeta de Identidad | |
CE | Cédula de Extranjeria | |
NI | Número de Identificación Tributaria | |
PS | Pasaporte | |
Peru | DNI_PER | Documento National de Identidad |
por | Partida de Nacimiento | |
No | Pasaporte | |
LMI | Libreta Militar | |
NAN | Otro |
Formato
language
Camino: customer.billingDetails.language
Código del idioma del comprador según la norma ISO 639-1.
Permite especificar el idioma en el que se envían los e-mails de confirmación de pago.
Formato
Valores posibles
Ejemplos de valores posibles:
Idioma | Código |
---|---|
Alemán (Alemania) | DE |
Inglés (Reino Unido) | EN |
Inglés (Estados Unidos) | EN |
Chino (tradicional) | ZH |
Español (España) | ES |
Español (Chile) | ES |
Francés (Francia) | FR |
Italiano (Italia) | IT |
Japonés (Japón) | JP |
Holandés (Países Bajos) | NL |
Polaco (Polonia) | PL |
Portugués (Brasil) | PT |
Portugués (Portugal) | PT |
Ruso (Rusia) | RU |
lastName
Camino: customer.billingDetails.lastName
Nombre del comprador.
Formato
legalName
Camino: customer.billingDetails.legalName
Razón social.
Formato
phoneNumber
Camino: customer.billingDetails.phoneNumber
Número de teléfono del comprador.
Acepta todos los formatos:
Ejemplos:
- 0123456789
- +33123456789
- 0033123456789
- (00.571) 638.14.00
- 40 41 42 42
Formato
state
Camino: customer.billingDetails.state
Región (estado) de la dirección de facturación. Es recomendable pero no obligatorio transmitir el valor ISO-3166-2.
Formato
streetNumber
Camino: customer.billingDetails.streetNumber
Número de calle de la dirección de facturación.
Carácteres aceptados:
- Caracteres alfabéticos (de la "A" a la "Z" y desde la "a" hasta la "z")
- Espacio
Formato
title
Camino: customer.billingDetails.title
Tratamiento del comprador.
Ejemplos:
- Sr.
- Sr.
- Sra.
Formato
zipCode
Camino: customer.billingDetails.zipCode
Código postal de la dirección de facturación.
Formato
address
Camino: customer.shippingDetails.address
Dirección de entrega.
Atención: Los caracteres > y < no están permitidos.
Formato
address2
Camino: customer.shippingDetails.address2
Segunda línea de la dirección de facturación.
Atención: Los caracteres > y < no están permitidos.
Formato
category
Camino: customer.shippingDetails.category
Tipo de cliente.
Formato
Valores posibles
Valores | Descripción |
---|---|
PRIVATE | Cliente de tipo Particular |
COMPANY | Cliente de tipo Empresa |
city
Camino: customer.shippingDetails.city
Ciudad de entrega.
Formato
country
Camino: customer.shippingDetails.country
País de entrega (en letras mayúsculas, según la norma ISO 3166-1 alfa-2).
Formato
Valores posibles
Ejemplos de valores posibles:
País | Código |
---|---|
AUSTRIA | AT |
Brasil | BR |
CÓRCEGA | FR |
COSTA DE MARFIL | CI |
FRANCIA | FR |
GUADALUPE | GP |
INDIA | IN |
MARTINICA | MQ |
NUEVA CALEDONIA | NC |
SAN PEDRO Y MIQUELÓN | PM |
POLINESIA FRANCESA | PF |
deliveryCompanyName
Camino: customer.shippingDetails.deliveryCompanyName
Nombre de la empresa emisora del producto.
Formato
district
Camino: customer.shippingDetails.district
Barrio de la dirección de facturación.
Formato
firstName
Camino: customer.shippingDetails.firstName
Nombre del destinatario.
Formato
identityCode
Camino: customer.shippingDetails.identityCode
Identificación nacional. Identifica de manera única a cada ciudadano en un país.
Formato
lastName
Camino: customer.shippingDetails.lastName
Nombre del comprador.
Formato
legalName
Camino: customer.shippingDetails.legalName
Razón social en caso de entrega a una empresa.
Formato
phoneNumber
Camino: customer.shippingDetails.phoneNumber
Número de teléfono del comprador.
Acepta todos los formatos:
Ejemplos:
- 0123456789
- +33123456789
- 0033123456789
- (00.571) 638.14.00
- 40 41 42 42
Formato
shippingMethod
Camino: customer.shippingDetails.shippingMethod
Modo de entrega.
Formato
Valores posibles
VALOR | Descripción |
---|---|
RECLAIM_IN_SHOP | Retiro en tienda. |
RELAY_POINT | Uso de una red de puntos de retiro de terceros (Kiala, Alveol, etc.). |
RECLAIM_IN_STATION | Retiro en un aeropuerto, una estación o una agencia de viajes. |
PACKAGE_DELIVERY_COMPANY | Entrega por transportista (Colissimo, UPS, etc.). |
ETICKET | Emisión de un ticket electrónico, descarga de producto virtual. |
CARD_HOLDER_ADDRESS | Entrega al comprador. Reservado para su uso futuro. |
VERIFIED_ADDRESS | Entrega a una dirección verificada. Reservado para su uso futuro. |
NOT_VERIFIED_ADDRESS | Entrega a una dirección no verificada. Reservado para su uso futuro. |
SHIP_TO_STORE | Entrega en tienda. Reservado para su uso futuro. |
DIGITAL_GOOD | Entrega digital. Reservado para su uso futuro. |
ETRAVEL_OR_ETICKET | Boleto electronico. Reservado para su uso futuro. |
OTHER | Otros Reservado para su uso futuro. |
PICKUP_POINT | Retiro en un punto de relevo. Reservado para su uso futuro. |
AUTOMATED_PICKUP_POINT | Recoger en el punto de relevo automático. Reservado para su uso futuro. |
shippingSpeed
Camino: customer.shippingDetails.shippingSpeed
Plazo de entrega.
Formato
Valores posibles
Ejemplos de valores posibles:
VALOR | Descripción |
---|---|
STANDARD | Entrega estándar |
EXPRESS | Entrega en 24 horas |
PRIORITY | Entrega prioritaria (Click & Collect) |
state
Camino: customer.shippingDetails.state
Región de la dirección de facturación.
Formato
streetNumber
Camino: customer.shippingDetails.streetNumber
Número de calle de la dirección de facturación.
Carácteres aceptados:
- Caracteres alfabéticos (de la "A" a la "Z" y desde la "a" hasta la "z")
- Espacio
Formato
zipCode
Camino: customer.shippingDetails.zipCode
Código postal de la dirección de facturación.
Formato
insuranceAmount
Camino: customer.shoppingCart.insuranceAmount
Monto del seguro para todo el pedido expresado en su fracción monetaria más pequeña (el centavo para el peso argentino).
Ejemplo: 30050 para 300,50 ARS.
Formato
shippingAmount
Camino: customer.shoppingCart.shippingAmount
Monto de los gastos de envío de todo el pedido expresado en su unidad monetaria más pequeña (el céntimo de peso argentino).
Ejemplo: 30050 para 300,50 ARS.
Formato
taxAmount
Camino: customer.shoppingCart.taxAmount
Monto de los impuestos de todo el orden expresado en su unidad monetaria más pequeña (el céntimo para el peso argentino).
Ejemplo: 30050 para 300,50 ARS.
Formato
cartItemInfo
Camino: customer.shoppingCart.cartItemInfo
cardItemInfo es una lista que contiene objetos Customer/ShoppingCartItemInfo.
Permite describir cada artículo del carrito.
Formato
productAmount
Camino: customer.shoppingCart.cartItemInfo.productAmount
Monto del producto expresada en su fracción monetaria más pequeña (el centavo para el peso argentino).
Ejemplo: 30050 para 300,50 ARS.
Formato
productLabel
Camino: customer.shoppingCart.cartItemInfo.productLabel
Nombre del producto.
Formato
productQty
Camino: customer.shoppingCart.cartItemInfo.productQty
Cantidad de producto.
Formato
productRef
Camino: customer.shoppingCart.cartItemInfo.productRef
Referencia del producto.
Formato
productType
Camino: customer.shoppingCart.cartItemInfo.productType
Tipo de producto.
Valores posibles
VALOR | Descripción |
---|---|
FOOD_AND_GROCERY | Alimentos y productos comestibles. |
AUTOMOTIVE | Automotriz / Motocicleta |
ENTERTAINMENT | Entretenimiento / Cultura |
HOME_AND_GARDEN | Casa y jardín |
HOME_APPLIANCE | Equipo de la casa |
AUCTION_AND_GROUP_BUYING | Subastas y compras a granel |
FLOWERS_AND_GIFTS | Flores y regalos |
COMPUTER_AND_SOFTWARE | Computadoras y software |
HEALTH_AND_BEAUTY | Salud y belleza |
SERVICE_FOR_INDIVIDUAL | Servicios a domicilio |
SERVICE_FOR_BUSINESS | Servicios de negocios |
SPORTS | Deportes |
CLOTHING_AND_ACCESSORIES | Ropa y accesorios |
TRAVEL | Viajes |
HOME_AUDIO_PHOTO_VIDEO | Sonido, imagen y video |
TELEPHONY | Telefonía |
Formato
productVat
Camino: customer.shoppingCart.cartItemInfo.productVat
Tipo de producto.
Monto del impuesto sobre el producto (en la unidad más pequeña de la moneda).
Valores posibles
VALOR | Descripción |
---|---|
Un número entero | Monto de la transacción. Su valor debe ser un entero positivo (por ejemplo: 1234 para 12,34 ARS). |
Un número decimal, inferior a 100 | Porcentaje aplicado sobre el importe. Ejemplos: 20,0 o 19,6532 |
Para expresar un porcentaje aplicado al monto del producto en cuestión, el valor debe tener un máximo de 4 dígitos después del punto decimal. El decimal es obligatorio para expresar un porcentaje. La posición decimal está marcada por el carácter ".".
Formato
paymentSource
Camino: transactionOptions.cardOptions.paymentSource
Origen del pago.
Formato
Valores posibles
Los valores posibles son:
VALOR | Descripción |
---|---|
EC | E-Commerce: el comprador ingresa los datos del medio de pago. Este valor permite tener una autentificación fuerte al momento del pago. |
MOTO | MAIL OR TELEPHONE ORDER: Ingreso realizado por un operador. Los datos del medio de pago se envían por correo postal o electrónico. Requiere un contrato de tipo VAD. |
CC | Call Center: pago realizado a través de un centro de atención telefónico. Requiere un contrato de tipo VAD. |
OTHER | Otro canal de venta. Valor de salida devuelto para los pagos realizados desde el |
Absent ou null | El valor predeterminado es “EC”. |
mid
Camino: transactionOptions.cardOptions.mid
Número de contrato del vendedor. Si este campo es completado, asegúrese de utilizar el contrato correcto en función de la red de la tarjeta.
Un contrato de VISANET no puede utilizarse para una transacción de MASTERCARD.
Formato
manualValidation
Camino: transactionOptions.cardOptions.manualValidation
Modo de validación de la transacción.
Formato
Valores posibles
Los valores posibles son:
VALOR | Descripción |
---|---|
NO | Validación automática por la plataforma de pago. |
YES | Validación manual por el vendedor. |
null | Configuración por defecto de la tienda seleccionada (configurable en el |
captureDelay
Camino: transactionOptions.cardOptions.captureDelay
Fecha límite para aplicar en la fecha de captura.
Descripción
Indica el número de días antes de la captura.
Si no se transmite este parámetro, se utiliza el valor predeterminado definido en el
Este último es configurable en el
Si el tiempo de entrega es mayor a 365 días en la solicitud de pago, se reposiciona automáticamente a 365 días.
Formato
firstInstallmentDelay
Camino: transactionOptions.cardOptions.firstInstallmentDelay
Cantidad de meses en los que se aplaza el primer pago de un pago a plazos. Campo específico a los adquirentes en Latino américa.
Formato
installmentNumber
Camino: transactionOptions.cardOptions.installmentNumber
Cantidad de cuotas.
Formato
retry
Camino: transactionOptions.cardOptions.retry
Número de nuevos intentos disponibles en caso de rechazo del pago (3 por defecto).
Formato
debitCreditSelector
Camino: transactionOptions.cardOptions.debitCreditSelector
Este campo es exclusivo para Brasil para la gestión de las tarjetas "multiplo".
Las tarjetas “Multiplo” son tarjetas de pago (Elo, Visa o Mastercard) que permiten pagar:
- ya sea en débito inmediato: el monto se debita inmediatamente y se acredita al vendedor al día siguiente.
- o en crédito: el débito se difiere y el monto puede debitarse en una o más cuotas. Al vendedor se le acredita posteriormente la totalidad o solo una parte del monto total.
Este campo permite forzar el uso de la tarjeta como tarjeta de débito o de crédito.
Valores posibles
Valores | Descripción |
---|---|
DEBIT | Uso de la función “débito” de la tarjeta |
CREDIT | Uso de la función “crédito” de la tarjeta |
Formato
taxAmount
Monto de los impuestos de todo el orden expresado en su unidad monetaria más pequeña (el céntimo para el peso argentino).
Ejemplo: 30050 para 300,50 ARS.
Formato
taxRate
Usado por ciertos medios de pago en América Latina. permite transmitir el tipo de impuesto aplicado a todo el pedido. El valor debe ser el porcentaje a aplicar (21 para 21 %).
Formato
useCase
Se utiliza para especificar el caso de uso deseado.
Valor posible
Valor que debe introducirse para el pago múltiple en el envío :
VALOR | Descripción |
---|---|
SHIPMENT_MULTIPLE_AUTHORISATION | Caso práctico "Pago al envío con autorizaciones múltiples |
Formato
overridePaymentCinematic
Le permite cambiar el modo de captura. Específico de los adquirientes de América Latina. Esta característica no se puede usar en Colombia.
Valores posibles:
VALOR | Descripción |
---|---|
IMMEDIATE_CAPTURE | Secuencia de captura inmediata: el adquiriente inicia la captura el día del pago. |
DELAYED_CAPTURE | Secuencia de captura diferida: la captura es iniciada por la plataforma de pago, siempre antes de que expire la solicitud de autorización. |
Formato
formTokenVersion
formTokenVersion define la versión del formToken enviada por el Web Service.
Este parámetro se utiliza en el marco del SDK móvil. Permite asegurarse de que la versión del formToken devuelta está siempre sincronizada con la aplicación móvil implementada en el teléfono del comprador.
El valor por defecto es 4.
Formato
companyType
Camino: subMerchantDetails.companyType
Tipo de empresa del subvendedor. Transmitido por el facilitador de pago.
Pueden aplicarse reglas diferentes según el adquiriente. A menudo este campo permite indicar el tipo de Legal Number
del comprador.
Fiserv
Valores posibles :
- NATIONAL_IDENTITY
- SINGLE_TAX_IDENTIFICATION
- SINGLE_CODE_OF_LABOR_IDENTIFICATION
- BOOK_ENLISTMENT
- CIVIC_NOTEBOOK
- PASSPORT
Más información: Fiserv.
PRISMA
Valores posibles :
- 0 para un CUIT: Código Único de Identificación Tributaria
- 1 para un CUIL: Código Único de Identificación Laboral
- 2 para un DNI: Documento Nacional de Identidad
Más información: Prisma.
Formato
legalNumber
Camino: subMerchantDetails.legalNumber
Número legal del subvendedor según el campo companyType
. Transmitido por el facilitador de pago.
Este campo es obligatorio para el adquirente Prisma. (Más información: Prisma ).
Formato
name
Camino: subMerchantDetails.name
Razón social del subvendedor. Transmitido por el facilitador de pago.
Formato
url
Camino: subMerchantDetails.url
URL del subvendedor. Transmitido por el facilitador de pago.
Formato
phoneNumber
Camino: subMerchantDetails.phoneNumber
Número de teléfono del subvendedor. Transmitido por el facilitador de pago.
Formato
address1
Camino: subMerchantDetails.address1
Dirección del subvendedor. Transmitido por el facilitador de pago.
Este campo es obligatorio para el adquirente Prisma. (Más información: Prisma ).
Formato
address2
Camino: subMerchantDetails.address2
Complemento de la dirección del subvendedor. Transmitido por el facilitador de pago.
Formato
zip
Camino: subMerchantDetails.zip
Código postal del subvendedor. Transmitido por el facilitador de pago.
Formato
city
Camino: subMerchantDetails.city
Ciudad del subvendedor. Transmitido por el facilitador de pago.
Formato
country
Camino: subMerchantDetails.country
Código del país de la dirección del subvendedor (norma ISO 3166 alpha-2). Transmitido por el facilitador de pago.
Formato
mcc
Camino: subMerchantDetails.mcc
Código MCC del subvendedor. Transmitido por el facilitador de pago.
Este campo es obligatorio para el adquirente Prisma. (Más información: Prisma ).
Formato
mid
Camino: subMerchantDetails.mid
Número de afiliación (MID) del subvendedor. Transmitido por el facilitador de pago.
Campo obligatorio para los adquirentes Fiserv y Procesos. (Más información: Fiserv.)
Formato
softDescriptor
Camino: subMerchantDetails.softDescriptor
Descripción (soft-descriptor) del subvendedor que aparece en el extracto de operaciones bancarias del comprador. Transmitido por el facilitador de pago.
- Para el adquirente Prisma , este campo es obligatorio y debe respetar el siguiente formato:
"CÓD.AGRUPADOR ASIGNADO POR PRISMA" * "NÚMERO FANTASÍA VENDEDOR".
El campo Softdescriptor se debe construir bajo el siguiente criterio:
Estructura:
Subcampo 1 : Nombre abreviado del Payment Facilitator o Marketplace, su longitud puede ser de 3, 7 o 12 posiciones. Este nombre debe coincidir con el valor informado en Anexo 1 campo 'Nombre del Payment Facilitator / Marketplace tal cual será enviado en Autorización'
Subcampo 2 : Informar valor fijo '*' en la posición 4, 8 o 13 según corresponda.
Subcampo 3 : Informar el nombre del establecimiento esponsoreado desde la posición 5, 9 0 14 según corresponda.
La longitud máxima sumando los subcampos 1, 2 y 3 no podrá superar las 25 posiciones
Long. total: 25 caracteres incluyendo el cód. de agrupador.
Caracteres aceptados: [A-Z];[0-9];[*].
Ejemplos:
- "TPP*ELECTONICA TUCUMAN"
- "MPP*MARTIN GONZALEZ"
Más información: Prisma.
- Para el adquirente Fiserv , este campo es obligatorio y debe respetar el siguiente formato:
"Pfac" * "subMerchantDetails.name".
El Pfac que ha elegido el vendedor permite construir este campo obligatorio concatenándolo con el campo subMerchantDetails.name.
Más información: Fiserv.
Formato
state
Camino: subMerchantDetails.state
Región de la dirección del subvendedor. Transmitido por el facilitador de pago.
Este campo es obligatorio para el adquirente Prisma. (Más información: Prisma ).
Formato
facilitatorId
Camino: subMerchantDetails.facilitatorId
Identificador del facilitador de pago. Transmitido por el facilitador de pago.
Este campo es obligatorio para el adquirente Prisma. (Más información: Prisma ).
Formato
Referencia de la respuesta
Existen varias respuestas posibles dependiendo del contexto:
Respuesta | Contexto |
---|---|
Payment | Objeto que contiene la transacción generada. Este objeto se devuelve directamente durante un pago con autentificación simple. |
Charge/PaymentForm | El objeto contiene un hash para utilizar con el formulario incrustado para crear una nueva transacción. |
Consulte la referencia de cada respuesta para más información.