Datos de Nivel II/III para el adquirente de First Data

Esta página contiene detalles de integración adicionales a los proporcionados en la guía de integración de Nivel II/III estándar, y es específica para el adquirente de First Data.

El motor de pagos enviará los datos de Nivel II/III proporcionados por usted al adquirente de First Data solo si proporciona al menos los siguientes campos:

  • Código postal de destino del envío (shipping.address.postcodeZip)
  • Código postal de origen del envío (shipping.origin.postcodeZip, si no se proporciona, el valor configurado en su perfil de negocio puede enviarse al adquirente).
  • Datos de transacción a nivel de artículo
    • cantidad del artículo (transaction.item[n].quantity)
    • código de producto del artículo (transaction.item[n].name)
    • unidad de medida del artículo (transaction.item[n].unitOfMeasure)
    • código de mercancía del artículo (transaction.item[n].detail.commodityCode o transaction.item[n].detail.acquirerCustom ={"XD34_4":"<non-integer item commodity code>"})
  • su ID de registro fiscal (order.taxRegistrationId (muy recomendado para lograr las mejores tasas de intercambio))

Datos de nivel II Copied to Clipboard

Para proporcionar los siguientes datos de Nivel II en su solicitud de transacción, utilice los campos correspondientes de nivel de pedido y/o de nivel de transacción de API, con los detalles de integración como se muestra en la columna "Valor de campo" de la siguiente tabla.

Datos de Nivel II Campo de nivel de pedido Campo de nivel de transacción Valor del campo
Referencia de compra del negocio order.reference
Si no se proporciona, el motor de pagos utiliza el valor proporcionado en order.id (campo obligatorio). 		- Este campo es obligatorio para tarjetas Mastercard (hasta 17 caracteres), pero opcional para tarjetas Visa (hasta 25 caracteres).
Número de referencia de cliente/titular de la tarjeta order.customerReference - Este campo es obligatorio para las tarjetas Mastercard y Visa.
Número de factura order.invoiceNumber - Este campo es obligatorio para las tarjetas Mastercard, pero opcional para las tarjetas Visa.
Monto de transporte y envío order.shippingAndHandlingAmount transaction.shippingAndHandlingAmount Si proporciona un monto de Transporte y envío, es posible que también deba proporcionar lo siguiente:
  • Código postal del origen del envío (shipping.origin.postcodeZip)
  • País de destino del envío (shipping.address.country)
Monto del impuesto order.taxAmount transaction.taxAmount Este campo es obligatorio para las tarjetas Mastercard, pero opcional para las tarjetas Visa.
Importe de derechos A partir de la versión 67 de la API, utilice lo siguiente:
order.dutyAmount
Para versiones de API inferiores a 67, utilice lo siguiente:
order.tax[n].type=DUTY
order.tax[n].amount		 A partir de la versión 67 de la API, utilice lo siguiente:
transaction.dutyAmount
Para versiones de API inferiores a 67, utilice lo siguiente:
transaction.tax[n].type=DUTY
transaction.tax[n].amount		 -

Datos de nivel III Copied to Clipboard

Para proporcionar los siguientes datos de Nivel III en su solicitud de transacción, utilice los campos correspondientes de nivel de pedido (del grupo de parámetros de order.item[n]) y/o de nivel de transacción (del grupo de parámetros de transaction.item[n]) de API, con los detalles de integración como se muestra en la columna "Valor de campo" de la siguiente tabla.

Datos de Nivel III Campo de nivel de pedido Campo de nivel de transacción Valor del campo
Unidad de medida del artículo order.item[n].unitOfMeasure transaction.item[n].unitOfMeasure
 Debe proporcionar el valor de enumeración correcto, según lo requiera su adquirente; consulte Valores de enumeración de unidad de medida del artículo.
Tipo de impuesto del artículo order.item[n].detail.unitTaxType transaction.item[n].detail.unitTaxType Debe proporcionar el valor de enumeración correcto para el código del tipo de impuesto, según lo requiera su adquirente; consulte Valores de enumeración de tipo de impuesto.
Tipo de impuesto del artículo [n] order.item[n].detail.tax[m].type transaction.item[n].detail.tax[m].type Solo los detalles proporcionados para el primer elemento de la lista (transaction.item[n].detail.unitTax[1].*) se enviarán al adquirente. Debe proporcionar el valor de enumeración correcto para el código del tipo de impuesto, según lo requiera su adquirente; consulte Valores de enumeración de tipo de impuesto.
Código de mercancía del artículo order.item[n].detail.acquirerCustom ={"XD34_4":"<non-integer item commodity code>"} transaction.item[n].detail.acquirerCustom ={"XD34_4":"<non-integer item commodity code>"} Use este campo si desea enviar un código de mercancía no entero para un artículo de línea. Para enviar un código de mercancía numérico para un artículo de línea, puede usar los campos order.item[n].detail.commodityCode o transaction.item[n].detail.commodityCode.
Valores de enumeración de tipo de impuesto

Proporcione el valor de enumeración de tipo de impuesto correcto en los campos order.item[n].detail.unitTaxType o transaction.item[n].detail.unitTaxType

Código de tipo de impuesto Descripción
00 Desconocido
01 Impuesto a las ventas federal/nacional
02 Impuesto a las ventas estatal
03 Impuesto a las ventas de la ciudad
04 Impuesto a las ventas local
05 Impuesto a las ventas municipal
06 Otros impuestos
10 Impuesto al valor agregado (IVA)
11 Impuesto sobre bienes y servicios (GST)
12 Impuesto a las ventas provincial
20 Impuesto de hospedaje
21 Impuesto de ocupación
22 Impuesto energético
Valores de enumeración de unidad de medida del artículo

Proporcione el valor de enumeración correcto de la unidad de medida para los artículos de línea en los campos order.item[n].unitOfMeasure y/o transaction.item[n].unitOfMeasure

Código de unidad de medida del artículo Descripción
ACR Acre (4840 yd2)
ASM Grado alcohólico másico
ASV Grado alcohólico volumétrico
AMP Amperio
AMH Amperio-hora (3,6 kC)
ARE Área (100 m2)
BAR Baro
BLL Barril (petróleo) (158,987 dm3)
BFT Pie tabla
BQL Becquerel
BIL Millar de millones EUR
MLD Millar de millones EE. UU.
BX ox
BHP Potencia de freno (245,7 vatios)
BTU Unidad térmica británica (1,055 kilojulios)
BUA Bushel (35,2391 dm3)
BUI Bushel (36,36874 dm3)
CDL Candela
CCT Carga útil en toneladas métricas
CS ase
CNT Centena corta (45,359237 kg)
CGM Centigramo
CLT Centilitro
CMT Centímetro
DTN Quintal métrico (100 kg) (sinónimo: decitonelada)
WCD Cuerda (3,63 m3)
COU Culombio
CKG Culombio por kilogramo
DMQ Decímetro cúbico
FTQ Pie cúbico
INQ Pulgada cúbica
MTQ Metro cúbico
MQH Metro cúbico por hora
MQS Metro cúbico por segundo
MMQ Milímetro cúbico
YDQ Yarda cúbica
CUR Curie
DAY Día
DEC Década (diez años)
DAA Decárea
DLT Decilitro
DMT Decímetro
CEL Grado Celsius
FAH Grado Fahrenheit
KEL Grado Kelvin: lo mismo que Kelvin
DPT Tonelaje de desplazamiento
DZN Docena
DZP Docena de barajas
DZR Docena de pares
DPC Docena de piezas
DRL Docena de rollos
DRM Dracma GB (3,887935 g)
DRI Dram GB (1,771745 g)
DRA Dram EE. UU. (3,887935 g)
BLD Barril árido (115,627 dm3)
GLD Galón árido (4,404884 dm3)
PTD Pinta árida (0,55061 dm3)
QTD Cuarto de galón árido (1,101221 dm3)
EA o EAC Unidad
FAR Faradio
OZI Onza líquida (28,413 cm3)
OZA Onza líquida (29,5735 cm3)
FOT Pie (0,3048 m)
GLI Galón (4,546092 dm3)
GBQ Gigabecquerel
GWH Gigavatios-hora (1 millón de kW / h)
GII Gill (0,142065 dm3)
GIA Gill (11,8294 cm3)
GRN Grano GB, EE. UU. (64,798910 mg)
GRM Gramo
GFI Gramo de isótopos fisionables
GGR Gran gruesa (12 gruesas)
GRO Gruesa
GRT Tonelaje (de registro) bruta
SAN Semestre
HAR Hectárea
HBA Hectobar
HGM Hectogramo
DTH Hectokilogramo
HLT Hectolitro
HPA Hectolitro de alcohol puro
HMT Hectómetro
HTZ Hercio
HUR Hora
CEN Centenar
BHX Centenar de cajas
HIU Centenar de unidades internacionales
CLF Centenar de hojas
CNP Centenar de barajas
CWA Centena corta (45,3592 kg)
INH Pulgada (25,4 mm)
ITM Artículo
JOU Joule
KEL Kelvin
KBA Kilobar
KGM Kilogramo
KPH Kilogramo de potasa cáustica
KSH Kilogramo de soda cáustica
KNS Kilogramo de sustancia designada
KNI Kilogramo de nitrógeno
KPP Kilogramo de anhídrido fosfónico
KPP Kilogramo de pentóxido de fósforo
KPH Kilogramo de hidróxido de potasio
KPO Kilogramo de óxido de potasio
KSD Kilogramo de materia 90 % seca
KUR Kilogramo de uranio
KMQ Kilogramo por metro cúbico
KGS Kilogramo por segundo
KHZ Kilohercio
KJO Kilogoule
KMT Kilómetro
KMH Kilómetro por hora
KPA Kilopascal
KTN Kilotón
KVR Kilovar
KVT Kilovoltio
KVA Kilovoltio-amperio
KWT Kilovatio
KWH Kilovatio-hora
KNT Nudo (1 milla náutica por hora)
LEF Hoja
GLL Galón líquido (3,7854l dm3)
PTL Pinta líquida (0,473176 dm3)
QTL Cuarto de galón líquido (0,946353 dm3)
LTR Litro (1 dm3)
LPA Litro de alcohol puro
LTN Tonelada larga GB, EE. UU. (1,0160469 t)
LUM Lumen
LUX Lux
MHZ Megahercio
MAL Megalitro
MAM Megametro
MPA Megapascal
MVA Megavoltio-amperio (1000 KVA)
MAW Megavatio
MWH Megavatio-hora (100 kW/h)
MTR Metro
MTS Medidor por segundo
MSK Metro por segundo al cuadrado
CTM Quilate métrico (200 mg = 2.10-4 kg)
TNE Tonelada métrica (1000 kg)
MBR Milibar
MCU Milicurie
MGM Miligramo
MI.T Mililitro
MMT Milímetro
MIO Millón
HMQ Millón de metros cúbicos
MIU Millón de unidades internacionales
MIN Minuto
MON Mes
NMI Milla náutica (1852 m)
NTT Tonelada (de registro) neta
NEW Newton
NMB Número
NAR Número de artículos
NBB Número de bobinas
NCL Número de celdas
NIU Número de unidades internacionales
NMP Cantidad de barajas
NMR Numero de pares
NPL Número de paquetes
NPT Número de partes
NRL Número de rollos
OHM Ohmio
ONZ Onza GB, EE. UU. (28,349523 g)
APZ Onza GB, EE. UU. (31,10348 g) (sinónimo: Onza troy)
PK Paquete
PAL Pascal
DWT Pennyweight GB, EE. UU. (1,555174 g)
PCE Pieza
PCB Pieza
PSC Pieza
PTI Pinta (0,568262 dm3)
LBR Libra GB, EE. UU. (0,45359237 kg)
PGL Galón de prueba
LBS Libras
QTI Cuarto (1,136523 dm3)
QAN Trimestre
QTR Quarter, GB (12,700586 kg)
RPM Revolución por minuto
RPS Revolución por segundo
SCO Clasificación
SCR Escrúpulo GB, EE. UU. (1,295982 g)
SEC Segundo
SET Juego
SHT Tonelada marina
SST Estándar corto (7200 cerillas)
SIE Siemensio
CMK Centímetro cuadrado
DMK Decímetro cuadrado
FTK Pie cuadrado
INK Pulgada cuadrada
KMK Kilómetro cuadrado
MTK Metro cuadrado
MIK Milla cuadrada
MMK Milímetro cuadrado
YDK Yarda cuadrada
WSD Estándar
ATM Atmósfera tipo (101325 Pa)
SMI Milla (terrestre) (1609,344 m)
STI Stone GB (6,350293 kg)
ATT Atmósfera técnica (98066,5 Pa)
DAD Diez días
TPR Diez pares
MIL Millar
TAH Mil amperios-hora
MBF Mil pies tabla (2,36 m3)
TQD Mil metros cúbicos por día
MBE Equivalente de mil ladrillos normalizados
TSH Tonelada de vapor por hora
TSD Tonelada de materia 90 % seca
TRL Billón EUR
APZ Onza troy
ST Unidad de medida desconocida
VLT Voltio
WTT Vatio
WHR Vatio-hora
WEB Weber
WEE Semana