Respuesta Pago
Payment es un objeto que describe el resultado de un pago. Es devuelto por el Web Service REST, Charge/CreatePayment, y por IPN.
El objeto Payment puede contener diversas transacciones.
Estructura del objeto Payment
El objeto Payment se estructura de la siguiente manera:
Generalmente, la lista transacciones solo contiene una transacción. Generalmente, la lista transactions solo contiene una transacción. Pero en caso de pago fraccionado (pedido pagado con distintos medios de pago), se pueden crear varias transacciones. Por eso, siempre debe utilizar los campos orderStatus y orderCycle para comprobar el estado del pedido.
Referencia de la respuesta
orderStatus
Estado consolidado de las transacciones contenidas en el pedido.
Descripción
Un pedido puede contener varias transacciones. OrderStatus consolida el status de todas las transacciones vinculadas al pedido.
Para más información, consulte: Ciclo de vida de una transacción
Valores posibles
. Los valores posibles son:
| STATUS | Descripción |
|---|---|
| PAID | El pedido ha sido pagado |
| UNPAID | El pedido no ha sido pagado |
| RUNNING | El pedido está en curso. |
| PARTIALLY_PAID | El pedido fue parcialmente pagado |
| ABANDONED | El pedido fue abandonada |
Formato
orderCycle
Define si el pedido está abierto (OPEN , el pago es autorizado) o cerrado(CLOSED , ya no puede ser modificado).
orderCycle toma el valor CLOSED si ya no se puede modificar:
- Cuando el pedido está totalmente pagado
- Cuando se agoten todos los intentos de pago autorizados
Sino, el valor de orderCycle se establece OPEN
Valores posibles
. Los valores posibles son:
| STATUS | Descripción |
|---|---|
| OPEN | El pedido está en curso. Debe conservar el carrito ya que pueden realizarse otras tentativas de pago. |
| CLOSED | El pedido está pagado en su totalidad o bien la última tentativa fue rechazada (en cuyo caso, debe generar un nuevo formToken). |
Formato
Casos de uso de OPEN
Por defecto, el comprador tiene 4 intentos para pagar su pedido. Mientras no se hayan efectuado todos estos intentos, orderCycle está establecido en OPEN.
Un pedido también se puede pagar con varias transacciones o varios medios de pago. Mientras no se pague todo el pedido, orderCycle se establece en OPEN.
Si la transacción asociada está en validación manual, orderCycle se establece en OPEN.
Casos de uso CLOSED
Si se paga el pedido completo, orderCycle se establecerá en CLOSED.
Cuando el pedido expira, orderCycle se establece en CLOSED.
Si fallan todos los intentos de pago autorizados (4, de forma predeterminada), orderCycle se establece en CLOSED.
Si la transacción fue creada inicialmente con validación manual, cuando la transacción se valide o se cancele, el valor de orderCycle será CLOSED.
shopId
Identificación de la tienda.
Formato
orderEffectiveAmount
Camino: orderDetails.orderEffectiveAmount
Monto original de la transacción en caso de conversión de moneda.
Formato
orderDetails.mode
Permite definir el modo en el cual se ha creado el pedido.
Valores posibles
. Los valores posibles son:
| STATUS | Descripción |
|---|---|
| TEST | para un pedido de test |
| PRODUCTION | para un pedido real |
Formato
orderCurrency
Camino: orderDetails.orderCurrency
Código de la moneda del pedido en formato 4217 alpha-3.
Ejemplo: "ARS" por el peso argentino.
Formato
orderDetails.orderId
Referencia de pedido definida por el vendedor. No admite los caracteres UTF-8.
Formato
orderTotalAmount
Camino: orderDetails.orderTotalAmount
Monto total del pedido expresado en su fracción monetaria más pequeña (el centavo para el peso argentino).
Ejemplo: 30050 para 300,50 ARS.
Formato
customer.reference
Identificador del comprador en el sitio web comercial.
Formato
customer.email
E-mail del comprador.
- Especificaciones de la estructura del correo electrónico: RFC-2822
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
ipAddress
Camino: customer.extraDetails.ipAddress
Dirección IP del comprador.
Formato
fingerPrintId
Camino: customer.extraDetails.fingerPrintId
Formato
browserUserAgent
Camino: customer.extraDetails.browserUserAgent
Encabezado “User-Agent” del navegador del comprador (HTTP/1.1 - RFC. 2616).
Formato
browserAccept
Camino: customer.extraDetails.browserAccept
Encabezado “Accept” del navegador del comprador (HTTP/1.1 - RFC. 2616).
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
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 :
- CUIT: Código Único de Identificación Tributaria
- CUIL: Código Único de Identificación Laboral
- 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
transactions.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
creationDate
Camino: transactions.creationDate
Fecha y hora de registro de la transacción.
Formato
currency
Camino: transactions.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 |
detailedErrorCode
Camino: transactions.detailedErrorCode
Código de error detallado devuelto por el adquirente, sin filtro ni modificación.
Consulte Lista de códigos de retorno de autorización Para más información.
Formato
detailedErrorMessage
Camino: transactions.detailedErrorMessage
Mensaje de error detallado devuelto por la aplicación de pago sin filtro.
Contiene información contextual para ayudar a entender el error.
El valor de este campo puede establecerse en null cuando errorCode es ACQ_001.
Consulte la descripción del campo detailedErrorCode para conocer el motivo del rechazo de la autorización.
Formato
detailedStatus
Camino: transactions.detailedStatus
El parámetro "detailedStatus" proporciona información detallada sobre el estado del pago. Cada uno de los estados es específico a los medios de pago utilizados.
Valores posibles
. Los valores posibles son:
| detailedStatus | Descripción |
|---|---|
| ACCEPTED | Estado de una transacción de tipo VERIFICATION cuya autorización o solicitud de información ha sido aceptada. Este estado no puede cambiar. Las transacciones con estado ACCEPTED no se capturan nunca. Se crea una transacción de tipo VERIFICATION al actualizar o crear un token sin pago. |
| AUTHORISED | El monto está autorizado y será retenido automáticamente. |
| AUTHORISED_TO_VALIDATE | La transacción, creada en validación manual, está autorizada. El vendedor debe validar manualmente la transacción para que sea capturada al banco. La transacción puede ser validada siempre y cuando la fecha de expiración de la solicitud de autorización no se haya vencida. Si esta fecha se supera, el pago toma el estado EXPIRED. El estado Expirado es definitivo. |
| CANCELLED | La transacción fue anulada. |
| CAPTURED | El importe de la transacción ha sido capturado. |
| CAPTURE_FAILED | La remesa de la transacción ha fallado. Contacte la asistencia. |
| EXPIRED | Se alcanzó la fecha de vencimiento de la solicitud de autorización sin que el vendedor valide la transacción. No se realizará el débito al titular. |
| INITIAL | Este estado es temporal. Se devuelve cuando no se recibe respuesta del adquirente o cuando el tiempo de respuesta del adquiriente sobrepasa la duración de la sesión de pago en la plataforma de pago. |
| PRE_AUTHORISED | Estado de una transacción de tipo PRE_AUTHORISATION cuya autorización ha sido aceptada. Este estado no puede cambiar. Las transacciones con estado PRE_AUTHORISED no se capturan nunca. |
| REFUSED | La transacción fue rechazada. |
| UNDER_VERIFICATION | Verificación del adquiriente en curso. Este estado no es definitivo. |
| WAITING_AUTHORISATION | El plazo de captura al banco es superior a la duración de validez de la autorización. |
| WAITING_AUTHORISATION_TO_VALIDATE | Se ha verificado el medio de pago pero aún no se ha autorizado la transacción porque el período de captura es superior al período de validez de la autorización. La solicitud de autorización se iniciará automáticamente D-1 antes de la fecha de captura y se requerirá una intervención manual para confirmar la autorización. No hay garantía de que la solicitud de autorización sea aceptada. |
| WAITING_FOR_PAYMENT | Transacción en espera de pago Este estado no es definitivo. |
| ERROR | Ocurrió un error inesperado. |
Para más información sobre el ciclo de vida de una transacción, consulte: Ciclo de vida de una transacción
Formato
Para más información sobre el ciclo de vida de una transacción, consulte: Ciclo de vida de una transacción
Formato
effectiveStrongAuthentication
Camino: transactions.effectiveStrongAuthentication
Indica si el titular se ha autentificado correctamente durante el pago.
Valores posibles
. Los valores posibles son:
| VALOR | Descripción |
|---|---|
| ENABLED | El titular ha sido autentificado satisfactoriamente. |
| DISABLED | El pago no está sujeto a la autentificación del titular de la tarjeta o la autentificación del titular de la tarjeta ha fallado. |
Formato
errorCode
Camino: transactions.errorCode
Código de error. Vea Códigos de error Para más información.
Formato
errorMessage
Camino: transactions.errorMessage
Mensaje de error. Vea Códigos de error Para más información.
Formato
metadata
Camino: transactions.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
operationType
Camino: transactions.operationType
Tipo de operación.
Valores posibles
. Los valores posibles son:
| VALOR | Descripción |
|---|---|
| DEBIT | Operación de débito |
| CREDIT | Transacción de reembolso |
| VERIFICATION | Operación de verificación de un medio de pago |
Formato
transactions.uuid
Referencia única de la transacción generada por la plataforma de pago.
Formato
paymentMethodToken
Camino: transactions.paymentMethodToken
Token asociado a un medio de pago.
Formato
paymentMethodType
Camino: transactions.paymentMethodType
Tipo de medio de pago. Ejemplo: PAYCONIQ
Formato
shopId
Identificación de la tienda.
Formato
transactions.status
Estado simplificado de la transacción. Es común para todos los medios de pago. Le permite implementar un código genérico compatible con todos los medios de pago.
Cada modo de pago tiene estados asignados. Ver la propiedad detailedStatus para más información.
Valores posibles
. Los valores posibles son:
| STATUS | Descripción |
|---|---|
| PAID | La transacción ha sido pagada. |
| UNPAID | La transacción no ha sido pagada |
| RUNNING | La transacción está en curso |
| PARTIALLY_PAID | La transacción ha sido parcialmente pagada |
Para más información sobre el ciclo de vida de una transacción, consulte: Ciclo de vida de una transacción
Formato
liabilityShift
Camino: transactions.transactionDetails.liabilityShift
Define si el pago está garantizado.
Valores posibles
. Los valores posibles son:
| Valores | Descripción |
|---|---|
| YES | el pago está garantizado |
| NO | el pago no está garantizado |
| nulle | el pago no está garantizado |
Formato
mid
Camino: transactions.transactionDetails.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
effectiveAmount
Camino: transactions.transactionDetails.effectiveAmount
Monto original de la transacción en caso de conversión de moneda.
Formato
sequenceNumber
Camino: transactions.transactionDetails.sequenceNumber
Número de secuencia de la transacción.
Formato
effectiveCurrency
Camino: transactions.transactionDetails.effectiveCurrency
Divisa original de la transacción en caso de conversión de divisa.
Formato
creationContext
Camino: transactions.transactionDetails.creationContext
Especifica el proceso que ha iniciado la transacción.
Valores posibles
. Los valores posibles son:
| Valores | Descripción |
|---|---|
| CHARGE | Para una solicitud de domiciliación |
| REFUND | Para una solicitud de crédito |
Formato
parentTransactionUuid
Camino: transactions.transactionDetails.parentTransactionUuid
UUID de la transacción fuente.
Formato
paymentSource
Camino: transactions.transactionDetails.cardDetails.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”. |
manualValidation
Camino: transactions.transactionDetails.cardDetails.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 |
expectedCaptureDate
Camino: transactions.transactionDetails.cardDetails.expectedCaptureDate
Fecha de la captura bancario expresada en formato ISO 8601 definida por W3C.
Formato
effectiveBrand
Camino: transactions.transactionDetails.cardDetails.effectiveBrand
Marca de la tarjeta.
| Medio de pago | Tipo de tarjeta (effectiveBrand) |
|---|---|
| American Express | AMEX |
| American Express Bansud | AMEX_BANSUD |
| American Express Cent Ar | AMEX_CENT_AR |
| American Express Corp Ar | AMEX_CORP_AR |
| American Express Galicia | AMEX_GALICIA |
| American Express HSBC | AMEX_HSBC |
| American Express Macro | AMEX_MACRO |
| American Express Naranja | AMEX_NARANJA |
| American Express Patagonia | AMEX_PATAGONIA |
| American Express Plat Ar | AMEX_PLAT_AR |
| American Express REBANKING | AMEX_REBANKING |
| American Express Santander | AMEX_SANTANDER |
| Cabal | CABAL |
| Cabal Débito | CABAL_DEBIT |
| Carnet | CARNET |
| Diners | DINERS |
| Discover | DISCOVER |
| Elo | ELO |
| Hiper | HIPER |
| Hipercard | HIPERCARD |
| JCB | JCB |
| Maestro | MAESTRO |
| Mastercard | MASTERCARD |
| Mastercard débito | MASTERCARD_DEBIT |
| Mastercard BBVA | MC_BBVA |
| Mastercard Cencosud | MC_CENCOSUD |
| Mastercard CityBank | MC_CITYBANK |
| Mastercard Columbia | MC_COLUMBIA |
| Mastercard Comafi | MC_COMAFI |
| Mastercard Cordobesa | MC_CORDOBESA |
| Mastercard Falabella | MC_FALABELLA |
| Mastercard Galicia | MC_GALICIA |
| Mastercard HSBC | MC_HSBC |
| Mastercard ICBC | MC_ICBC |
| Mastercard Itau | MC_ITAU |
| Mastercard Macro | MC_MACRO |
| Mastercard Nación | MC_NACION |
| Mastercard Patagonia | MC_PATAGONIA |
| Mastercard Santander | MC_SANTANDER |
| Naranja | NARANJA |
| PAYPAL | PayPal |
| PAYPAL_BNPL | PayPal Pay Later |
| PAYPAL_SB | PayPal - Mode sandbox |
| PAYPAL_BNPL_SB | PayPal Pay Later- Mode sandbox |
| Billetera electrónica PIM | PIM |
| Sorocred | SOROCRED |
| Tuya | TUYA |
| Visa | VISA |
| Visa BBVA | VISA_BBVA |
| Visa Chaco | VISA_CHACO |
| Visa Ciudad | VISA_CIUDAD |
| Visa Columbia | VISA_COLUMBIA |
| Visa Comafi | VISA_COMAFI |
| Visa Cordobesa | VISA_CORDOBESA |
| Visa Corrientes | VISA_CORRIENTES |
| Visa Credicoop | VISA_CREDICOOP |
| Visa débito | VISA_DEBIT |
| Visa Electron | VISA_ELECTRON |
| Visa Formosa | VISA_FORMOSA |
| Visa Galicia | VISA_GALICIA |
| Visa Hipotecario | VISA_HIPOTECARIO |
| Visa HSBC | VISA_HSBC |
| Visa ICBC | VISA_ICBC |
| Visa Industrial | VISA_INDUSTRIAL |
| Visa Itau | VISA_ITAU |
| Visa Macro | VISA_MACRO |
| Visa Nación | VISA_NACION |
| Visa Neuquen | VISA_NEUQUEN |
| Visa Patagonia | VISA_PATAGONIA |
| Visa Provincia | VISA_PROVINCIA |
| Visa Santander | VISA_SANTANDER |
Formato
pan
Camino: transactions.transactionDetails.cardDetails.pan
Número de tarjeta truncado.
Formato
expiryMonth
Camino: transactions.transactionDetails.cardDetails.expiryMonth
Mes de expiración en 2 dígitos. Ejemplo: "09" por septiembre.
Formato
expiryYear
Camino: transactions.transactionDetails.cardDetails.expiryYear
Año de expiración en 2 dígitos. Ejemplo: "25" por 2025.
Formato
country
Camino: transactions.transactionDetails.cardDetails.country
Código de país de la tarjeta.
Formato
issuerCode
Camino: transactions.transactionDetails.cardDetails.issuerCode
Código bancario asociado al banco emisor.
Formato
issuerName
Camino: transactions.transactionDetails.cardDetails.issuerName
Nombre del banco asociado al banco emisor.
Formato
effectiveProductCode
Camino: transactions.transactionDetails.cardDetails.effectiveProductCode
Código de producto de la tarjeta utilizada para el pago.
| VISA | Designación |
|---|---|
| a | VISA TRADITIONAL |
| B | Visa Traditional Rewards |
| C | Visa Signature |
| D | Visa Signature Preferred |
| E | Proprietary ATM |
| F | Visa Classic |
| G | Visa Business |
| G1 | Visa Signature Business |
| G2 | Reserved |
| G3 | Visa Business Enhanced |
| G4 | Visa Infinite Business |
| G5 | Visa Business Rewards |
| H | Reserved |
| I | Visa Infinite |
| I1 | Visa Infinite Privilege |
| I2 | Visa Ultra High Net Worth |
| J | Reserved |
| J1 | Reserved |
| J2 | Reserved |
| J3 | Visa Healthcare |
| J4 | Reserved |
| K | Visa Corporate T&E |
| K1 | Visa GSA Corporate T&E |
| L | Electron |
| N | Visa Platinium |
| N1 | TBA |
| N2 | Visa Select |
| P | Visa Gold |
| Q | Private Label |
| Q1 | Reserved |
| Q2 | Private Label Basic |
| Q3 | Private Label Standard |
| Q4 | Private Label Enhanced |
| Q5 | Private Label Specialized |
| Q6 | Private Label Premium |
| R | Proprietary |
| S | Visa Purchasing |
| S1 | Visa Purchasing |
| S2 | Visa Purchasing |
| S3 | Visa Purchasing |
| S4 | Government Services Loan |
| S5 | Commercial Transport EBT |
| S6 | Business Loan |
| S7 | Visa Distribution |
| T | Reserved |
| U | Visa TravelMoney |
| V | Visa VPay |
| W | Reserved |
| X | Reserved |
| y | Reserved |
| Z | Reserved |
| MASTERCARD | Designación |
|---|---|
| BPD | MASTERCARD BUSINESS PREMIUM DEBIT |
| CIR | CIRRUS |
| DAG | GOLD DEBIT MASTERCARD SALARY |
| DAP | PLATINUM DEBIT MASTERCARD SALARY |
| DAS | STANDARD DEBIT MASTERCARD SALARY |
| DDB | DOMESTIC DEBIT BRAND |
| DLG | DEBIT GOLD DELAYED DEBIT |
| DLH | DEBIT WORLD EMBOSSED DELAYED DEBIT |
| DLP | DEBIT PLATINUM DELAYED DEBIT |
| DLS | MASTERCARD CARD-DELAYED DEBIT |
| DOS | STANDARD DEBIT MASTERCARD SOCIAL |
| DWF | DEBIT MASTERCARD HUMANITARIAN PREPAID |
| Sr. | MASTERCARD |
| MAB | WORLD ELITE MASTERCARD |
| MAC | MASTERCARD CORPORATE WORLD ELITE |
| MAP | MASTERCARD COMMERCIAL PAYMENTS ACCOUNT |
| MBB | MASTERCARD PREPAID CONSUMER |
| MBC | MASTERCARD PREPAID VOUCHER |
| MBD | MASTERCARD PROFESSIONAL DEBIT BUSINESS CARD |
| MBE | MASTERCARD ELECTRONIC BUSINESS CARD |
| MBK | MASTERCARD BLACK |
| MBP | MASTERCARD UNKNOWN PRODUCT |
| MBS | MASTERCARD B2B PRODUCT |
| MBT | MASTERCARD CORPORATE PREPAID TRAVEL |
| MBW | WORLD MASTERCARD BLACK EDITION – DEBIT |
| MCB | MASTERCARD BUSINESS CARD |
| MCC | MASTERCARD CREDIT MIXED BIN CARD |
| MCD | MASTERCARD DEBIT CARD |
| MCE | MASTERCARD ELECTRONIC CARD |
| MCF | MASTERCARD FLEET CARD |
| MCG | MASTERCARD GOLD CARD |
| MCH | MASTERCARD PREMIUM CHARGE |
| MCO | MASTERCARD CORPORATE CARD |
| MCP | MASTERCARD PURCHASING CARD |
| MCS | MASTERCARD STANDARD CARD |
| MCT | TITANIUM MASTERCARD CARD |
| MCV | MERCHANT BRANDED PROGRAM |
| MCW | WORLD MASTERCARD CARD |
| MDB | DEBIT MASTERCARD BUSINESSCARD CARD |
| MDG | DEBIT GOLD MASTERCARD CARD |
| MDH | DEBIT OTHER EMBOSSED |
| MDJ | DEBIT OTHER 2 EMBOSSED |
| MDL | BUSINESS DEBIT OTHER EMBOSSED |
| MDN | BUSINESS DEBIT OTHER 2 EMBOSSED |
| MDO | DEBIT OTHER CARD |
| MDP | DEBIT PLATINUM CARD |
| MDR | DEBIT BROKERAGE CARD |
| MDS | DEBIT MASTERCARD CARD |
| MDT | MASTERCARD BUSINESS DEBIT |
| MDW | WORLD ELITE DEBIT MASTERCARD |
| MEB | MASTERCARD EXECUTIVE BUSINESS CARD |
| MEC | MASTERCARD ELECTRONIC COMMERCIAL CARD |
| MEF | ELECTRONIC PAYMENT ACCOUNT |
| MEO | MASTERCARD CORPORATE EXECUTIVE CARD |
| MET | TITANIUM DEBIT MASTERCARD CARD |
| MFB | FLEX WORLD ELITE |
| MFD | FLEX PLATINUM |
| MFE | FLEX CHARGE WORLD ELITE |
| MFH | FLEX WORLD |
| MFL | FLEX CHARGE PLATINUM |
| MFW | FLEX CHARGE WORLD |
| MGF | MASTERCARD GOUVERNMENT COMMERCIAL CARD |
| MHA | MASTERCARD HEALTHCARE PREPAID NON-TAX |
| MHB | MASTERCARD HSA SUBSTANTIATED (DEBIT MASTERCARD) |
| MHD | HELOC DEBIT STANDARD |
| MHH | MASTERCARD HSA NON-SUBSTANTIATED (DEBIT MASTERCARD) |
| MHL | HELOC DEBIT GOLD |
| MHM | HELOC DEBIT PLATINUM |
| MHN | HELOC DEBIT PREMIUM |
| MIA | PREPAID MASTERCARD UNEMBOSSED STUDENT CARD |
| MIP | PREPAID DEBIT MASTERCARD STUDENT CARD |
| MIU | DEBIT MASTERCARD UNEMBOSSED |
| MLA | MASTERCARD CENTRAL TRAVEL SOLUTIONS AIR CARD |
| MLD | MASTERCARD DISTRIBUTION CARD |
| MLL | MASTERCARD CENTRAL TRAVEL SOLUTIONS LAND CARD |
| MNF | MASTERCARD PUBLIC SECTOR COMMERCIAL CARD |
| MNW | MASTERCARD NEW WORLD |
| MOC | MASTERCARD UNKNOWN PRODUCT |
| MOG | MAESTRO GOLD |
| MOP | MAESTRO PLATINIUM |
| MOW | MAESTRO WORLD |
| MPA | MASTERCARD PREPAID DEBIT STANDARD-PAYROLL |
| MPB | PREFERRED BUSINESS CARD |
| MPC | MPC |
| MPD | MASTERCARD FLEX PREPAID |
| MPF | MASTERCARD PREPAID DEBIT STANDARD-GIFT |
| MPG | MASTERCARD UNEMBOSSED PREPAID STUDENT CARD |
| MPH | MASTERCARD CASH PREPAID |
| MPJ | PREPAID DEBIT MASTERCARD CARD GOLD |
| MPK | PREPAID MASTERCARD GOUVERNMENT COMMERCIAL CARD |
| MPL | PLATINIUM MASTERCARD CARD |
| MPM | MASTERCARD PREPAID DEBIT STANDARD-CONSUMER INCENTIVE |
| MPN | MASTERCARD PREPAID DEBIT STANDARD-INSURANCE |
| MPO | MASTERCARD PREPAID DEBIT STANDARD-OTHER |
| MPP | PRE-PAID CARD |
| MPR | MASTERCARD PREPAID DEBIT STANDARD-TRAVEL |
| MPT | MASTERCARD PREPAID DEBIT STANDARD-TEEN |
| MPV | MASTERCARD PREPAID DEBIT STANDARD-GOVERNMENT |
| MPW | DEBIT MASTERCARD BUSINESS CARD PREPAID WORK B2B |
| MPX | MASTERCARD PREPAID DEBIT STANDARD-FLEX BENEFIT |
| MPY | MASTERCARD PREPAID DEBIT STANDARD-EMPLOYEE INCENTIVE |
| MPZ | MASTERCARD PREPAID DEBIT STANDARD – GOVERNMENT CONSUMER |
| MRC | MASTERCARD ELECTRONIC CONSUMER PREPAID |
| MRF | MASTERCARD EUROPEAN REGULATED INDIVIDUAL PAY |
| MRG | MASTERCARD STANDARD PREPAID |
| MRH | MASTERCARD UNKNOWN PRODUCT |
| MRJ | PREPAID MASTERCARD GOLD CARD |
| MRK | PREPAID MASTERCARD PUBLIC SECTOR COMMERCIAL CARD |
| MRL | PREPAID MASTERCARD ELECTRONIC COMMERCIAL CARD (NON-US) |
| MRO | MASTERCARD REWARDS ONLY |
| MRP | STANDARD RETAILER CENTRIC PAYMENTS |
| MRW | MASTERCARD CREDIT BUSINESS CARD PREPAID |
| MSA | PREPAID MAESTRO PAYROLL CARD |
| MSB | MAESTRO SMALL BUSINESS CARD |
| MSF | PREPAID MAESTRO GIFT CARD |
| MSG | PREPAID MAESTRO CONSUMER RELOADABLE CARD |
| MSI | MAESTRO |
| MSJ | PREPAID MAESTRO GOLD |
| MSM | PREPAID MAESTRO CONSUMER PROMOTION CARD |
| MSN | PREPAID MAESTRO INSURANCE CARD |
| MSO | PREPAID MAESTRO OTHER CARD |
| MSQ | RESERVED FOR FUTURE USE |
| MSR | PREPAID MAESTRO TRAVEL CARD |
| MST | PREPAID MAESTRO TEEN CARD |
| MSV | PREPAID MAESTRO GOVERNMENT BENEFIT CARD |
| MSW | PREPAID MAESTRO CORPORATE CARD |
| MSX | PREPAID MAESTRO FLEX BENEFIT CARD |
| MSY | PREPAID MAESTRO EMPLOYEE INSENTIVE CARD |
| MSZ | PREPAID MAESTRO EMERGENCY ASSISTANCE CARD |
| MTP | MASTERCARD PLATINUM PREPAID TRAVEL (UK AND BRAZIL) |
| MUW | WORLD DOMESTIC AFFLUENT |
| MWB | WORLD MASTERCARD FOR BUSINESS |
| MWD | WORLD DEFERRED |
| MWE | MASTERCARD WORLD ELITE |
| MWF | MASTERCARD HUMANITARIAN PREPAID |
| MWO | MASTERCARD CORPORATE WORLD |
| MWR | WORLD RETAILER CENTRIC PAYMENTS |
| OLB | MAESTRO SMALL BUSINESS DELAYED DEBIT |
| OLG | MAESTRO GOLD DELAYED DEBIT |
| OLP | MAESTRO PLATINUM DELAYED DEBIT |
| OLS | MAESTRO-DELAYED DEBIT |
| OLW | MAESTRO WORLD DELAYED DEBIT |
| PVA | PRIVATE LABEL A |
| PVB | PRIVATE LABEL B |
| PVC | PRIVATE LABEL C |
| PVD | PRIVATE LABEL D |
| PVE | PRIVATE LABEL E |
| PVF | PRIVATE LABEL F |
| PVG | PRIVATE LABEL G |
| PVH | PRIVATE LABEL H |
| PVI | PRIVATE LABEL I |
| PVJ | PRIVATE LABEL J |
| PVL | PRIVATE LABEL CARD |
| SAG | GOLD MASTERCARD SALARY–IMMEDIATE DEBIT |
| SAL | STANDARD MAESTRO SALARY |
| SAP | PLATINUM MASTERCARD SALARY–IMMEDIATE DEBIT |
| SAP | PLATINUM MASTERCARD SALARY IMMEDIATE DEBIT |
| SAS | STANDARD MASTERCARD SALARY–IMMEDIATE DEBIT |
| SOS | STANDARD MASTERCARD SOCIAL–IMMEDIATE DEBIT |
| SUR | PREPAID MASTERCARD UNEMBOSSED (NON-US) |
| SUR | PREPAID UNEMBOSSED MASTERCARD CARD (NON-US) |
| TBE | MASTERCARD ELECTRONIC BUSINESS IMMEDIATE DEBIT |
| TCB | MASTERCARD BUSINESS CARD-IMMEDIATE DEBIT |
| TCC | MASTERCARD MIXED BIN-IMMEDIATE DEBIT |
| TCE | MASTERCARD ELECTRONIC IMMEDIATE DEBIT |
| TCF | MASTERCARD FLEET CARD IMMEDIATE DEBIT |
| TCG | LD MASTERCARD CARD-IMMEDIATE DEBIT |
| TCO | MASTERCARD (CORPORATE) IMMEDIATE DEBIT |
| TCP | MASTERCARD PURCHASING CARD IMMEDIATE DEBIT |
| TCS | MASTERCARD STANDARD CARD-IMMEDIATE DEBIT |
| TCW | WORLD SIGNIA MASTERCARD CARD-IMMEDIATE DEBIT |
| TEB | MASTERCARD EXECUTIVE BUSINESS CARD IMMEDIATE DEBIT |
| TEC | MASTERCARD ELECTRONIC COMMERCIAL IMMEDIATE DEBIT |
| TEO | MASTERCARD CORPORATE EXECUTIVE IMMEDIATE DEBITCARD |
| TIU | TIU |
| TNF | MASTERCARD PUBLIC SECTOR COMMERCIAL CARD IMMEDIATE DE |
| TNW | MASTERCARD NEW WORLD-IMMEDIATE DEBIT |
| TPB | PREFERRED BUSINESS CARD IMMEDIATE DEBIT |
| TPL | PLATINUM MASTERCARD IMMEDIATE DEBIT |
| TWB | WORLD MASTERCARD BLACK EDITION IMMEDIATE DEBIT |
| WBE | MASTERCARD UNKNOWN PRODUCT |
| WDR | WORLD DEBIT MASTERCARD REWARDS |
| WMR | WORLD MASTERCARD REWARDS |
| CB | Designación |
|---|---|
| 1 | Tarjeta nacional de retiro |
| 2 | Tarjeta nacional de retiro y pago |
| 3 | Tarjeta nacional de pago |
| 4 | Tarjeta nacional de pago y retiro con autorización sistemática |
| 5 | Tarjeta nacional de pago con autorización sistemática |
| Otros códigos de producto | Designación |
|---|---|
| AX | AMERICAN EXPRESS |
| DI | DISCOVER |
| DN | DINERS |
| JC | JCB |
Formato
paymentMethodSource
Camino: transactions.transactionDetails.cardDetails.paymentMethodSource
Permite caracterizar el modo de medio de pago utilizado.
Valores posibles
. Los valores posibles son:
| STATUS | Descripción |
|---|---|
| NEW | Transacción creada a partir de un nuevo medio de pago. |
| TOKEN | Transacción creada a partir de un medio de pago existente. |
Formato
legacyTransId
Camino: transactions.transactionDetails.cardDetails.legacyTransId
Identificador de la transacción en 6 caracteres.
Formato
cardHolderName
Camino: transactions.transactionDetails.cardDetails.cardHolderName
Nombre completo del titular de la tarjeta
Formato
identityDocumentType
Camino: transactions.transactionDetails.cardDetails.identityDocumentType
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 | |
| TE | Tarjeta De Extranjería | |
| DE | Documento De Identificación Extranjero | |
| RN | Registro Civil De Nacimiento | |
| Peru | DNI_PER | Documento National de Identidad |
| PAR | Partida de Nacimiento | |
| PAS | Pasaporte | |
| LMI | Libreta Militar | |
| NAN | Otro |
Formato
identityDocumentNumber
Camino: transactions.transactionDetails.cardDetails.identityDocumentNumber
Número del documento de identidad del comprador.
El formato depende del tipo de documento de identidad: entre 7 y 13 caracteres, números, letras y/o puntos.
En América Latina, este parámetro puede ser obligatorio para algunos adquirentes.
Formato
legacyTransDate
Camino: transactions.transactionDetails.cardDetails.legacyTransDate
Fecha y hora de recepción de la solicitud de pago. Utilizada para encontrar las transacciones de id con formato antiguo.
Formato
productCategory
Camino: transactions.transactionDetails.cardDetails.productCategory
Categoría del producto de la tarjeta.
El valor proviene de los archivos de rango BIN.
Valores posibles
| VALOR | Descripción |
|---|---|
| CREDIT | Tarjeta crédito |
| DEBIT | Tarjeta débito |
| PREPAID | Tarjeta prepago |
Formato
nature
Camino: transactions.transactionDetails.cardDetails.nature
Naturaleza de la tarjeta.
Campo vacío si no ha sido facilitado por el adquirente.
Valores posibles
| VALOR | Descripción |
|---|---|
| CONSUMER_CARD | Tarjeta personal |
| COMMERCIAL_CARD | Tarjeta corporativa |
Formato
amount
Camino: transactions.transactionDetails.cardDetails.authorizationResponse.amount
Monto de la autorización.
Formato
currency
Camino: transactions.transactionDetails.cardDetails.authorizationResponse.currency
Código de la moneda utilizada en la solicitud de autorización.
Formato
authorizationDate
Camino: transactions.transactionDetails.cardDetails.authorizationResponse.authorizationDate
Fecha y hora de la solicitud de autorización.
Formato
authorizationNumber
Camino: transactions.transactionDetails.cardDetails.authorizationResponse.authorizationNumber
Número de la solicitud de autorización.
Formato
authorizationResult
Camino: transactions.transactionDetails.cardDetails.authorizationResponse.authorizationResult
Código de retorno de la solicitud de autorización.
Consulte Lista de códigos de retorno de autorización Para más información.
Formato
authorizationMode
Camino: transactions.transactionDetails.cardDetails.authorizationResponse.authorizationMode
Especifica cómo realizar la solicitud de autorización.
Valores posibles
| Valores | Descripción |
|---|---|
| MARK | Se realizó una preautorización de un monto nulo o unitario. Véase más adelante. |
| FULL | Autorización por el monto total indicado en la solicitud. |
Cuando "authorizationMode" está establecido en MARK : Se realizó una autorización de para verificar la validez de la tarjeta. Este caso se presenta cuando la fecha de depósito supera el periodo de validez de una autorización (7 días para VISA / MasterCard / CB / AMEX en Francia por ejemplo).
Formato
amount
Camino: transactions.transactionDetails.cardDetails.markAuthorizationResponse.amount
Monto de la preautorización.
Formato
currency
Camino: transactions.transactionDetails.cardDetails.markAuthorizationResponse.currency
Código de la moneda utilizada durante la solicitud de preautorización.
Formato
authorizationDate
Camino: transactions.transactionDetails.cardDetails.markAuthorizationResponse.authorizationDate
Fecha y hora de la solicitud de preautorización.
Formato
authorizationNumber
Camino: transactions.transactionDetails.cardDetails.markAuthorizationResponse.authorizationNumber
Número de la solicitud de preautorización.
Formato
authorizationResult
Camino: transactions.transactionDetails.cardDetails.markAuthorizationResponse.authorizationResult
Código de retorno de la solicitud de preautorización.
Formato
captureDate
Camino: transactions.transactionDetails.cardDetails.captureResponse.captureDate
Fecha y hora de la captura.
Formato
captureFileNumber
Camino: transactions.transactionDetails.cardDetails.captureResponse.captureFileNumber
Número de captura.
Formato
refundAmount
Camino: transactions.transactionDetails.cardDetails.captureResponse.refundAmount
Monte reembolsado.
Formato
refundCurrency
Camino: transactions.transactionDetails.cardDetails.captureResponse.refundCurrency
Moneda del monte reembolsado.
Formato
effectiveRefundAmount
Camino: transactions.transactionDetails.cardDetails.captureResponse.effectiveRefundAmount
Formato
effectiveRefundCurrency
Camino: transactions.transactionDetails.cardDetails.captureResponse.effectiveRefundCurrency
Formato
transactionCondition
Camino: transactions.transactionDetails.cardDetails.threeDSResponse.authenticationResultData.transactionCondition
Estado de la autentificación 3-D Secure.
Valores posibles
Estado de la autentificación del titular.
| VALOR | Descripción |
|---|---|
| COND_3D_SUCCESS | Éxito de la autentificación. El vendedor y el titular de la tarjeta están afiliados al programa 3-D Secure y el titular se ha autentificado correctamente. |
| COND_3D_FAILURE | Fallo de la autentificación. El vendedor y el titular de la tarjeta están afiliados al programa 3-D Secure pero el comprador no ha logrado autentificarse (contraseña incorrecta). |
| COND_3D_ERROR | autentificación en error. El vendedor está afiliado al programa 3-D Secure pero se produjo un error en el servidor de la plataforma de pago durante el proceso de autentificación (al verificar la inscripción de la tarjeta en el programa 3D o al autentificar al titular). |
| COND_3D_NOTENROLLED | Titular no enrolado. El vendedor participa en el programa 3-D Secure pero la tarjeta del titular no está afiliada. |
| COND_3D_ATTEMPT | Tentativa de autentificación. El vendedor y el titular de la tarjeta están afiliados al programa 3-D Secure, pero el comprador no se ha autentificado (el ACS del emisor solo genera una prueba de intento de autentificación). |
| COND_SSL | 3-D Secure no aplicable. El vendedor no está afiliado a 3-D Secure o el canal de venta no está cubierto por esta garantía. |
Formato
enrolled
Camino: transactions.transactionDetails.cardDetails.threeDSResponse.authenticationResultData.enrolled
Estado de registro del titular.
Valores posibles
. Los valores posibles son:
| VALOR | Descripción |
|---|---|
| YES | Titular inscrito, autentificación 3DS posible. Nota: En el Back Office, aparece el valor ENROLLED (pestaña 3-D Secure de Detalles de una transacción). |
| NO | Titular no enrolado. Nota: En el Back Office, aparece el valor NOT_ENROLLED (pestaña 3-D Secure de Detalles de una transacción). |
| UNKNOWN | No se puede verificar el estado de la inscripción. Nota: En el Back Office, se muestra el valor UNAVAILABLE (pestaña 3-D Secure de Detalles de una transacción). |
Formato
status
Camino: transactions.transactionDetails.cardDetails.threeDSResponse.authenticationResultData.status
Estado de la autentificación del titular.
Valores posibles
Estado de la autentificación del titular.
| VALOR | Descripción |
|---|---|
| YES | autentificación exitosa. Nota: En el Back Office, se muestra el valor SUCCESS (pestaña 3-D Secure de Detalles de una transacción). |
| NO | Error de autentificación. Nota: En el Back Office, aparece el valor FAILED (pestaña 3-D Secure de Detalles de una transacción). |
| UNKNOWN | autentificación imposible. Nota: En el Back Office, se muestra el valor UNAVAILABLE (pestaña 3-D Secure de Detalles de una transacción). |
| ATTEMPT | Prueba de autentificación. Nota: En el Back Office, se muestra el valor ATTEMPT (pestaña 3-D Secure de Detalles de una transacción). |
Formato
eci
Camino: transactions.transactionDetails.cardDetails.threeDSResponse.authenticationResultData.eci
Indicador de comercio electrónico.
Valores posibles
El valor ECI es función del estado de autentificación 3DS y del tipo de tarjeta. Los valores posibles son:
| TIPO DE TARJETA | STATUS=Y | STATUS=A | STATUS=U | STATUS=N |
|---|---|---|---|---|
| VISA - AMEX | 5 | 6 | 7 | - |
| MasterCard | 02 | 01 | - | - |
Formato
xid
Camino: transactions.transactionDetails.cardDetails.threeDSResponse.authenticationResultData.xid
Identificador único de la transacción.
Formato
cavvAlgorithm
Camino: transactions.transactionDetails.cardDetails.threeDSResponse.authenticationResultData.cavvAlgorithm
Algoritmo de verificación de la autentificación del titular.
Valores posibles
. Los valores posibles son:
| VALOR | Descripción |
|---|---|
| HMAC | HMAC |
| CVV | Card Verification Value |
| CVV_ATN | CVV Authentication Tracking Number |
| SPA | MasterCard SPA Algorithm. |
| A | AV-CB |
Formato
cavv
Camino: transactions.transactionDetails.cardDetails.threeDSResponse.authenticationResultData.cavv
Cardholder Authentication Verification Value.
Formato
signValid
Camino: transactions.transactionDetails.cardDetails.threeDSResponse.authenticationResultData.signValid
Validez de la firma del mensaje PaRes.
Valores posibles
Estado de la autentificación del titular.
| VALOR | Descripción |
|---|---|
| nulle | Sin 3DS. |
| 0 | firma incorrecta. |
| 1 | firma correcta. |
Formato
brand
Camino: transactions.transactionDetails.cardDetails.threeDSResponse.authenticationResultData.brand
Marca de la tarjeta.
Formato
id
Camino: transactions.transactionDetails.cardDetails.authenticationResponse.id
ID único de autentificación, en formato UUID.
Formato
operationSessionId
Camino: transactions.transactionDetails.cardDetails.authenticationResponse.operationSessionId
Identificador único para la sesión de autentificación.
Formato
instructionType
Camino: transactions.transactionDetails.cardDetails.authenticationResponse.value.instructionType
Tipo de instrucción a realizar.
Formato
Valores posibles
| Valores | Descripción |
|---|---|
| FORM | Instrucciones de tipo redireccionamiento para formularios. |
name
Camino: transactions.transactionDetails.cardDetails.authenticationResponse.value.name
Nombre de la instrucción.
Valores posibles
| VALOR | Descripción |
|---|---|
| CHALLENGE | Instrucción Challenge, que permite la autentificación interactiva del usuario con el ACS. |
| FINGERPRINT | Instrucción Fingerprint, que permite la autentificación interactiva del usuario con el ACS. |
Formato
_type
Camino: transactions.transactionDetails.cardDetails.authenticationResponse.value._type
Tipo de respuesta recibida. La interpretación del resto de la respuesta depende de este atributo.
Valores posibles
| VALOR | Descripción |
|---|---|
| AuthenticationInstruction | Respuesta del tipo de instrucción |
| AuthenticationResult | Respuesta del tipo Resultado final |
Formato
timeout
Camino: transactions.transactionDetails.cardDetails.authenticationResponse.value.timeout
Tiempo máximo de espera para la respuesta al ejecutar una instrucción, expresada en segundos. Más allá de este tiempo, es conveniente forzar el retorno al servidor de la plataforma de pago para obtener el resultado final.
Formato
method
Camino: transactions.transactionDetails.cardDetails.authenticationResponse.value.http.method
Método (verbo) utilizado para la solicitud.
Valores posibles
| VALOR | Descripción |
|---|---|
| DELETE | Método Delete |
| GET | Método Get |
| PATCH | Método Patch |
| POST | Método Post |
| PUT | Método Put |
Formato
url
Camino: transactions.transactionDetails.cardDetails.authenticationResponse.value.http.url
Url para presentar en el formulario http.
Formato
body
Camino: transactions.transactionDetails.cardDetails.authenticationResponse.value.http.body
Lista de parámetros del cuerpo de la solicitud, en forma de "nombre": Valor.
Formato
headers
Camino: transactions.transactionDetails.cardDetails.authenticationResponse.value.http.headers
Lista de encabezados de la solicitud http, en forma de "nombre": Valor
Formato
element
Camino: transactions.transactionDetails.cardDetails.authenticationResponse.value.target.element
Tipo de elemento destino html en el que se materializará la instrucción.
Valores posibles
| VALOR | Descripción |
|---|---|
| IFRAME | iFrame |
Formato
height
Camino: transactions.transactionDetails.cardDetails.authenticationResponse.value.target.height
Altura del objetivo html en píxeles.
Formato
visible
Camino: transactions.transactionDetails.cardDetails.authenticationResponse.value.target.visible
Booleano indicando si el objetivo html debe ser visible o no.
Formato
width
Camino: transactions.transactionDetails.cardDetails.authenticationResponse.value.target.width
Altura del objetivo html en píxeles.
Formato
showUrl
Camino: transactions.transactionDetails.cardDetails.authenticationResponse.value.target.showUrl
Campo técnico para uso interno, que permite mostrar u ocultar la URL del ACS.
Formato
challengePreference
Camino: transactions.transactionDetails.cardDetails.authenticationResponse.protocol.challengePreference
Indica si el vendedor solicita un "challenge" o no.
Valores posibles
| Valores | Descripción |
|---|---|
| NO_PREFERENCE | Ninguna preferencia principalmente |
| NO_CHALLENGE_REQUESTED | El challenge no se pregunta explícitamente. |
| CHALLENGE_REQUESTED | El "challenge" es solicitado por el vendedor. |
Formato
name
Camino: transactions.transactionDetails.cardDetails.authenticationResponse.protocol.name
Nombre del protocolo de autentificación del titular de la tarjeta.
Valores posibles
| VALOR | Descripción |
|---|---|
| THREEDS | Protocolo 3-D Secure |
Formato
simulation
Camino: transactions.transactionDetails.cardDetails.authenticationResponse.protocol.simulation
Booleano que indica si la autentificación debe realizarse en modo de simulación. Si establece el valor de este campo obligatorio en:
true, se activa el modo de simulación.false, no se activa el modo simulación.
El modo de simulación permite lograr una integración comercial sin estar en producción, ni utilizar tarjetas reales.
Formato
network
Camino: transactions.transactionDetails.cardDetails.authenticationResponse.protocol.network
Red en la que se autentificó el medio de pago.
Redes compatibles actualmente
| VALOR |
|---|
| VISA |
| MASTERCARD |
| AMEX_SAFEKEY |
| ELO |
| PROTECTBUY |
Formato
version
Camino: transactions.transactionDetails.cardDetails.authenticationResponse.protocol.version
Versión del protocolo de autentificación del titular de la tarjeta.
Versiones actualmente soportadas
| VALOR | Descripción |
|---|---|
| 1.0.2 | Versión 1.0.2 |
| 2.1.0 | Versión 2.1.0 |
| 2.2.0 | Versión 2.2.0 |
Formato
authenticationType
Camino: transactions.transactionDetails.cardDetails.authenticationResponse.value.authenticationType
El tipo de autentificación que tuvo lugar.
Valores posibles
| VALOR | Descripción |
|---|---|
| FRICTIONLESS | autentificación en modo Frictionless, es decir, de forma transparente para el cliente |
| CHALLENGE | Autentificación con Challenge, el cliente tuvo que autentificarse explícitamente con el ACS |
| DATA_ONLY | Autentificación tratada por el DS sin interacción del cliente |
Formato
commerceIndicator
Camino: transactions.transactionDetails.cardDetails.authenticationResponse.value.commerceIndicator
El indicador de comercio, llamado ECI (Electronic Commerce Indicator) para el protocolo 3DS. Indicador devuelto por el ACS para indicar los resultados del intento de autentificación del titular de la tarjeta.
En caso de autentificación sin pago (registro de una tarjeta) Mastercard puede devolver estos 2 valores:
| VALOR | Descripción |
|---|---|
| N0 | Not authenticated |
| N2 | Authenticated |
Formato
status
Camino: transactions.transactionDetails.cardDetails.authenticationResponse.value.status
El estado de autentificación, es decir, el resultado positivo/negativo de la autentificación.
Valores posibles
| VALOR | Descripción |
|---|---|
| ATTEMPT | Prueba de intento de autentificación cuando la autentificación no está disponible |
| ENROLLED_UNAVAILABLE | No se puede obtener el estado de inscripción |
| FAILED | autentificación incorrecta |
| NOT_ENROLLED | Tarjeta no enrolada |
| SUCCESS | autentificación exitosa |
| UNAVAILABLE | No se pudo completar la autentificación (error técnico, etc.) |
| DISABLED | Activación de la autentificación solicitada |
| REJECTED | autentificación rechazada por el ACS |
Formato
authenticationIdType
Camino: transactions.transactionDetails.cardDetails.authenticationResponse.value.authenticationId.authenticationIdType
El tipo de autentificación que tuvo lugar.
Valores posibles
| VALOR | Descripción |
|---|---|
| dsTransId | El campo proviene del campo xid del protocolo 3DS V2. |
Formato
value
Camino: transactions.transactionDetails.cardDetails.authenticationResponse.value.authenticationId.value
Valor del identificador de la transacción de autenticación conocida por la red bancaria.
La longitud del campo varía según el protocolo de autentificación.
| PROTOCOLO | Formato / Longitud | valor Ejemplo: |
|---|---|---|
| 3DS v2 (dsTransId) | chaine / 32 caractères alphanumériques + 4 tirets | 4317fdc3-ad24-5443-8000-000000000891 |
Formato
authenticationValueType
Camino: transactions.transactionDetails.cardDetails.authenticationResponse.value.authenticationValue.authenticationValueType
Tipo del valor de autentificación.
Valores posibles
| VALOR | Descripción |
|---|---|
| AEVV | American Express Verification Value (utilizado por Amex) |
| CAVV | Cardholder Authentication Verification Value (utilizado por VISA) |
| AAV | Accountholder Authentication Value (utilizado por Mastercard) |
Formato
value
Camino: transactions.transactionDetails.cardDetails.authenticationResponse.value.authenticationValue.value
Valor de autentificación final (según el DS, este valor puede denominarse CAVV, AEVV o AAV). Cadena de caracteres codificada en base 64 con un tamaño de 28 caracteres.
Formato
authenticationType
Camino: transactions.transactionDetails.cardDetails.authenticationResponse.value.extension.authenticationType
Tipo de extensión del resultado.
Formato
Valores posibles
| Valores | Descripción |
|---|---|
| THREEDS_V2 | Extensión para las autentificaciones 3DS Secure v2 |
acsTransId
Camino: transactions.transactionDetails.cardDetails.authenticationResponse.value.extension.acsTransId
Identifiant de transaction de l'ACS. Ce champ concerne uniquement le réseau CB. Voir : Guide d'intégration
Formato
cbScore
Camino: transactions.transactionDetails.cardDetails.authenticationResponse.value.extension.cbScore
Puntaje CB como se define en la extensión CB del mensaje ARES
Formato
algorithm
Camino: transactions.transactionDetails.cardDetails.authenticationResponse.value.extension.algorithm
Código del algoritmo utilizado para generar el Valor de autentificación (utilizado durante la autorización)
Valores posibles
| VALOR | Descripción |
|---|---|
| 0 | HMAC |
| 1 | CVV |
| 2 | CVV con ATN |
| 3 | MasterCard SPA |
Formato
code
Camino: transactions.transactionDetails.cardDetails.authenticationResponse.value.reason.code
Código adicional informativo sobre el origen del resultado. Ejemplo: DS_TIMEOUT
Formato
message
Camino: transactions.transactionDetails.cardDetails.authenticationResponse.value.reason.message
Mensaje adicional que proporciona información sobre el origen del resultado.
Formato
installmentNumber
Camino: transactions.transactionDetails.cardDetails.installmentNumber
Cantidad de cuotas.
Formato
installmentCode
Camino: transactions.transactionDetails.cardDetails.installmentCode
Código de la opción de pago utilizada para el pago.
Formato
subscriptionId
Camino: transactions.transactionDetails.subscriptionDetails.subscriptionId
Identificador de la recurrencia.
Formato
name
Camino: transactions.transactionDetails.fraudManagement.riskControl.name
Nombre del control aplicado en el marco de la gestión de riesgos.
Valores posibles
. Los valores posibles son:
| VALOR | Descripción |
|---|---|
| CARD_FRAUD | Control de la presencia del número de la tarjeta del comprador en la lista negra de tarjetas. |
| SUSPECT_COUNTRY | Controla la presencia del país emisor de la tarjeta del comprador en la lista de países prohibidos. |
| IP_FRAUD | Controlar la presencia de la dirección IP del comprador en la lista negra de IP. |
| CREDIT_LIMIT | Control de la frecuencia y el monto de compras de un mismo número de tarjeta, o del monto máximo de un pedido. |
| BIN_FRAUD | Control de la presencia del código BIN de la tarjeta del comprador en la lista negra de códigos BIN. |
| ECB | Controla si la tarjeta del comprador es de tipo débito. |
| COMMERCIAL_CARD | Controla si la tarjeta del comprador es una tarjeta comercial. |
| SYSTEMATIC_AUTO | Controla si la tarjeta del comprador es una tarjeta con autorización sistemática. |
| INCONSISTENT_COUNTRIES | Controla si el país de la dirección IP, el país emisor de la tarjeta de pago y el país de la dirección del comprador son coherentes entre ellos. |
| NON_WARRANTY_PAYMENT | Control de la transferencia de responsabilidad de la transacción. |
| SUSPECT_IP_COUNTRY | Control de la presencia del país del comprador, identificado por su dirección IP, en la lista lista de países prohibidos. |
Formato
result
Camino: transactions.transactionDetails.fraudManagement.riskControl.result
Nombre del control aplicado en el marco de la gestión de riesgos.
Valores posibles
Resultado del control de riesgo.
| VALOR | Descripción |
|---|---|
| OK | OK |
| WARNING | Control informativo no exitoso |
| ERROR | Control de bloqueo no exitoso. |
Formato
score
Camino: transactions.transactionDetails.fraudManagement.riskAnalysis.score
Identificador del análisis para el analizador de riesgo.
Formato
resultCode
Camino: transactions.transactionDetails.fraudManagement.riskAnalysis.resultCode
Código de retorno de un analizador de riesgo externo.
Valores posibles
. Los valores posibles son:
| STATUS | Descripción |
|---|---|
| INVALID_CREDENCIAL | Problema de configuración del contrato de análisis de riesgos. |
| COMUNICATION_PROBLEM | No es posible comunicarse con el analizador de riesgos. |
| DATA_PROCESSING_PROBLEM | Problema al procesar el envío o la respuesta de análisis de riesgos. |
| MISSING_MANDATORY_ORDER_INFO | Faltan los datos del pedido. |
| MISSING_MANDATORY_SHIPPING_INFO | Faltan los datos de entrega. |
| MISSING_MANDATORY_SHIPPING_ADDRESS_INFO | Faltan datos sobre la dirección de entrega. |
| MISSING_MANDATORY_BILLING_INFO | Faltan datos de facturación. |
| MISSING_MANDATORY_BILLING_ADDRESS_INFO | Faltan datos sobre la dirección de facturación |
| MISSING_MANDATORY_CARD_INFO | Faltan datos relativos a los medios de pago. |
| MISSING_MANDATORY_CUSTOMER_INFO | Faltan datos sobre el comprador. |
| APA | Específico de ClearSale La transacción se aprueba automáticamente de acuerdo con los parámetros definidos. |
| APM | Específico de ClearSale La transacción es aprobada manualmente por un analista. |
| RPM | Específico de ClearSale El pedido es denegado por falta de información del comprador de acuerdo con la política aplicada. |
| AMA | Específico de ClearSale Esperando análisis manual. El pedido está pendiente de análisis. |
| ERR | Específico de ClearSale Error. |
| NVO | Específico de ClareSale. Nuevo pedido. En espera de procesamiento y clasificación. |
| SUS | Específico de ClearSale Pedido suspendido manualmente. El pedido se suspende por sospecha de fraude. |
| CAN | Específico de ClearSale Pedido cancelado. El pedido es cancelado por el comprador. |
| FRD | Específico de ClearSale Fraude confirmado con el operador de la tarjeta de crédito o el titular de la tarjeta. |
| RPA | Específico de ClearSale Pedido denegado automáticamente. El pedido es denegado bajo los parámetros del analizador de fraude externo. |
| RPP | Específico de ClearSale Pedido denegado automáticamente. El pedido es denegado bajo la política del cliente o ClearSale. |
| 100 | Específico de CyberSource. La transacción fue exitosa. |
| 101 | Específico de CyberSource. La transacción se ha rechazado. Faltan uno o más campos. |
| 102 | Específico de CyberSource. La transacción se ha rechazado. Uno o más campos contienen datos inválidos. |
| 150 | Específico de CyberSource. Error. |
| 151 | Específico de CyberSource. Error. Se recibió la solicitud pero se excedió el plazo. Este error no incluye tiempos de espera entre el cliente y el servidor. |
| 152 | Específico de CyberSource. Error. La solicitud fue recibida pero un servicio no se completó a tiempo. |
| 202 | Específico de CyberSource. Denegada. Tarjeta expirada. |
| 231 | Específico de CyberSource. Denegada. Número de cuenta inválido. |
| 234 | Específico de CyberSource. Denegado. Hubo un problema con la configuración de CyberSource del vendedor. |
| 400 | Específico de CyberSource. Denegada. La puntuación del fraude supera el umbral de tolerancia. |
| 480 | Específico de CyberSource. El pedido está marcado para revisión por el Decision Manager. |
| 481 | Específico de CyberSource. El pedido fue denegado por el Decision Manager. |
| APPROVE | Específico de Konduto. Konduto recomienda aceptar la transacción. Si ninguna regla no contradice esta recomendación, el estado de la transacción será AUTHORISED (autorizada). |
| DECLINE | Específico de Konduto. Konduto recomienda denegar la transacción. El estado de la transacción será REFUSED (rechazada). |
| REVIEW | Específico de Konduto. Konduto recomienda verificar la transacción. Dependiendo del resultado de la autentificación 3-D Secure, el estado de la transacción será: |
| AUTHORISED_TO_VALIDATE | En caso de autentificación exitosa del titular. |
| REFUSED | En caso de fallo de autentificación del titular. |
Formato
status
Camino: transactions.transactionDetails.fraudManagement.riskAnalysis.status
Código de retorno de un analizador de riesgo externo.
Estado del análisis de riesgo.
Valores posibles
. Los valores posibles son:
| VALOR | Descripción |
|---|---|
| P_SEND_OK | Éxito. “Sent to clearsale and successfully processed”. |
| P_TO_SEND | El envío se programa. "Transaction analysis is scheduled to be sent to risk analyzer". |
| P_TO_SEND_KO | Error de procesamiento. “Problem when tried to send to risk analyzer”. |
| P_PENDING_AT_ANALYZER | “Analysis result is still being processed by the risk analyzer. We should keep checking/waiting for the analysis result”. |
| P_MANUAL | En espera de envío manual. "Analysis should be requested through user request (not automatically)" |
| P_SKIPPED | Descartada. “Analysis request discarded by current transaction status/problem”. |
| P_SEND_EXPIRED | Expirado.* “Analysis request expired”. |
Formato
requestId
Camino: transactions.transactionDetails.fraudManagement.riskAnalysis.requestId
Identificador del análisis para el analizador de riesgo.
Formato
extraInfo
Camino: transactions.transactionDetails.fraudManagement.riskAnalysis.extraInfo
Específico de CyberSource. Códigos de retorno del DecisionManager.
Formato
fingerPrintId
Camino: transactions.transactionDetails.fraudManagement.riskAnalysis.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
results
Camino: transactions.transactionDetails.fraudManagement.riskAssessments.results
Lista de acciones realizadas en la transacción, tras la aplicación de las reglas de gestión de riesgo avanzadas activadas en la tienda.
Los valores posibles dependen de las opciones de las tiendas.
Valores posibles
. Los valores posibles son:
| VALOR | Descripción |
|---|---|
| ENABLE_3DS |
|
| DISABLE_3DS |
|
| NO_PREFERENCE |
|
| NO_CHALLENGE_REQUESTED |
|
| CHALLENGE_REQUESTED |
|
| CHALLENGE_MANDATE |
|
| MANUAL_VALIDATION | La transacción se crea con validación manual. La captura del pago se bloquea temporalmente para que el vendedor pueda realizar las verificaciones que desee. |
| REFUSE | La transacción se ha rechazado. |
| RUN_RISK_ANALYSIS | Llamar a un analizador de riesgos externo siempre que el vendedor tenga un contrato. Consultar la descripción del objeto TransactionDetails.FraudManagement.RiskAnalysis para identificar la lista de valores posibles y su descripción. |
| INFORM | Se emite una alerta. Se advierte al vendedor que se ha identificado un riesgo. Se informa al vendedor a través de una o más de las reglas del centro de notificación (URL de notificación, e-mail o SMS). |
Formato
taxRate
Camino: transactions.transactionDetails.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
taxAmount
Camino: transactions.transactionDetails.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
preTaxAmount
Camino: transactions.transactionDetails.preTaxAmount
Permite definir el monto sin impuestos de todo el pedido.
El valor debe expresarse en la fracción monetaria más pequeña de la moneda.
Formato
externalTransactionId
Camino: transactions.transactionDetails.externalTransactionId
Referencia externa de la transacción.
Formato
dccAmount
Camino: transactions.transactionDetails.dcc.dccAmount
Monto de la transacción expresado en la unidad más pequeña de la moneda elegida por dccCurrency (el céntimo para el euro).
Este campo solo se valora si la tarjeta es elegible para el servicio de conversión dinámica de moneda (DCC) y el comprador ha elegido pagar en la moneda de su tarjeta.
La tasa de conversión se devuelve en el campo vads_change_rate.
Formato
dccCurrency
Camino: transactions.transactionDetails.dcc.dccCurrency
Código numérico según la norma ISO 4217 de la moneda elegida por el comprador cuando la tarjeta es válida para el servicio de conversión dinámica de moneda (DCC).
Este campo solo se valora si la tarjeta es elegible para el servicio de conversión dinámica de moneda (DCC) y el comprador ha elegido pagar en la moneda de su tarjeta.
La tasa de conversión se devuelve en el campo vads_change_rate.
Formato
dccChangeRate
Camino: transactions.transactionDetails.dcc.dccChangeRate
Tasa de cambio utilizada para calcular el monto real del pago.
Formato
dccMarkup
Camino: transactions.transactionDetails.dcc.dccMarkup
Indica el porcentaje (o tasa) de margen comercial sobre el importe total.
Este campo solo se valora si la tarjeta es elegible para el servicio de conversión dinámica de moneda (DCC) y el comprador ha elegido pagar en la moneda de su tarjeta.
Ejemplo: "3.5" para una tasa de margen de 3.5%.
Formato
dccRateDate
Camino: transactions.transactionDetails.dcc.dccRateDate
Fecha y hora UTC de la obtención de la tasa de conversión ante el servicio de conversión dinámica de moneda (DCC).
Este campo solo se valora si la tarjeta es elegible para el servicio de conversión dinámica de moneda (DCC) y el comprador ha elegido pagar en la moneda de su tarjeta.
La tasa de conversión se devuelve en el campo vads_change_rate.
Formato
paymentReference
Camino: transactions.transactionDetails.acquirerDetails.paymentReference
Referencia de pago que aparece en el cupón de pago.
Utilizado principalmente por el medio de pago Multibanco.
Formato
serviceSupplier
Camino: transactions.transactionDetails.acquirerDetails.serviceSupplier
ID de la entidad para la que se ha realizado el pago.
Utilizado principalmente por el medio de pago Multibanco.
Formato
nsu
Camino: transactions.transactionDetails.nsu
Número de secuencia único (América Latina).
Formato
tid
Camino: transactions.transactionDetails.tid
Terminal ID. Identificador del punto de venta definido en la afilación de aceptación.
Este campo solo se utiliza en Colombia para elegir entre REDEBAN y CREDIBANCO.
Formato
acquirerNetwork
Camino: transactions.transactionDetails.acquirerNetwork
Código de la red del adquirente.
Valores posibles:
| Código Red | Nombre |
|---|---|
| AMEXGLOBAL | American Express International |
| FIRSTDATA_IPG | First Data IPG |
| LINK | LINK |
| PAYPAL | PayPal |
| PAYPAL_BNPL | PayPal Pay Later |
| PAYPAL_SB | PayPal - Modo sandbox |
| PAYPAL_BNPL_SB | Pago Oney Pay Later - Modo sandbox |
| PIM | PIM |
| PRISMA | PRISMA |
Formato
taxRefundAmount
Camino: transactions.transactionDetails.taxRefundAmount
Utilizado en Uruguay, este campo corresponde al importe del crédito de impuesto acordado al vendedor para la transacción. El valor se expresa en la fracción monetaria más pequeña (el centavo para el peso argentino).
Ejemplo: 30050 para 300,50 ARS.
Formato
occurrenceType
Camino: transactions.transactionDetails.occurrenceType
Permite identificar si la transacción es parte de una serie de pagos (suscripción o pago en N cuotas).
útil para identificar de forma precisa el primer pago de una serie.
Con la aplicación del soft decline, la plataforma de pago realiza automáticamente un nuevo intento de pago con autentificación 3-D Secure cuando es posible. Esto modifica el número de secuencia de pago. El campo sequenceNumber ya no facilita la identificación del primer pago de una serie.
Valores posibles
| VALOR | Descripción |
|---|---|
| RECURRENT_INITIAL | Primer pago de una serie. |
| RECURRENT_INTERMEDIAIRE | Enésimo pago de una serie. |
| RECURRENT_FINAL | último pago de una serie. |
| UNITAIRE | Pago unitario (pago al contado). |
Formato
archivalReferenceId
Camino: transactions.transactionDetails.archivalReferenceId
Referencia generada por la plataforma de pago y transmitida al adquirente para el procesamiento de las capturas y la conciliación de las transacciones.
Establecido únicamente para los pagos CB, AMEX y PAYPAL.
Formato
serverDate
Fecha de generación de la respuesta. Se utiliza para medir la posible brecha entre los servidores del vendedor y el servicio de pago.