- Pautas de integración
- Características soportadas (otras características)
- Datos adicionales
- Datos de Nivel II y Nivel III
- Datos de Nivel II/III para el adquirente de First Data
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.commodityCodeotransaction.item[n].detail.acquirerCustom ={"XD34_4":"<non-integer item commodity code>"})
- cantidad del artículo (
- su ID de registro fiscal (
order.taxRegistrationId(muy recomendado para lograr las mejores tasas de intercambio))
Datos de nivel II
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.referenceSi 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:
|
| 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.dutyAmountPara versiones de API inferiores a 67, utilice lo siguiente: order.tax[n].type=DUTYorder.tax[n].amount |
A partir de la versión 67 de la API, utilice lo siguiente:transaction.dutyAmountPara versiones de API inferiores a 67, utilice lo siguiente: transaction.tax[n].type=DUTYtransaction.tax[n].amount |
- |
Datos de nivel III
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 |