AMEX | DEUNA Docs

In questa pagina

Integrare AMEX
Carte di prova
Dati tecnici: ISO 8583 Autorizzazione
Prossimo passo

American Express (AMEX) è una rete di pagamento globale di primo piano conosciuta per i titolari di carte di alto valore e i protocolli di sicurezza avanzati. Integrando direttamente con AMEX tramite ISO 8583, I commercianti di Deuna bypassano i gateway di terze parti per ridurre latenza, ridurre al minimo i costi di elaborazione e ottenere il controllo granulare sui dati delle transazioni.

Operazioni sostenute

L'integrazione AMEX nella strategia di pagamento con DEUNA consente di eseguire le seguenti operazioni:

Operazioni	Nome AMEX	MTI Richiesta / Risposta
Autorizzazione	Autorizzazione	1100/ 1110
Acquisto (Auto Capture in Deuna)	Autorizzazione	1100 / 1110
Giorno completo di rimborso/Rimborso parziale	Rimborso	Richiesta off-line
Cattura completa / parziale	Capture	Richiesta off-line
Giorno intero di rimborso	Autorizzazione inversione	1420 / 1430
Void	Autorizzazione inversione	1420 / 1430

Caratteristiche supportate

3DS (Deuna o MPI esterno)
Installazioni
MOTO
Informazioni sulla linea aerea

Metodi di pagamento supportati

Carte di credito e debito: Visa, Mastercard, AMEX

Processo di insediamento

L'integrazione AMEX richiede un processo a due fasi per offrire un processo di riconciliazione più affidabile ed efficiente. Invece di cancellare ogni singola transazione una per una in tempo reale, tutte le autorizzazioni approvate sono raggruppate e inviate insieme alla fine della giornata in un unico file batch. Questo rende la contabilità quotidiana, l'auditing e la verifica degli errori significativamente più gestibile. Il taglio avviene alle ore 11:00 di CDMX.

Questo processo si riflette nello stato di pagamento in Deuna come spiegato nella seguente tabella:

Operazioni	Nome AMEX	MTI Richiesta / Risposta	Pre Settlement Stato Deuna	Deuna Stato dopo l'insediamento
Autorizzazione	Autorizzazione	1100/ 1110	Autorizzato	Autorizzato (senza cambiamento)
Acquisto (Auto Capture)	Autorizzazione	1100 / 1110	Lavorazione	Processi
Giorno completo di rimborso/Rimborso parziale	Rimborso	Richiesta off-line	Rimborso / Rimborsamento parziale	Rimborsato / Rimborsato parziale
Cattura completa / parziale	Capture	Richiesta off-line	Catturazione / cattura parziale	Catturato / Partial Captured
Giorno intero di rimborso	Autorizzazione inversione	1420 / 1430	Rimborsato	Rimborso (nessuna modifica, cancellazione online)
Void	Autorizzazione inversione	1420 / 1430	Voi stessi	Voided (nessuna modifica, cancellazione online)

Integrare AMEX#

Come orchestratore di pagamento e frode, la nostra piattaforma consente di collegare facilmente il tuo account commerciale AMEX direttamente nel flusso di pagamento. Questo consente di sfruttare le capacità di elaborazione di AMEX come parte di una strategia di pagamento basata su regole e sofisticata, aiutandoti a ottimizzare i tassi di accettazione e a ridurre i costi.

Questa guida vi guiderà attraverso le credenziali necessarie per collegare AMEX nel nostro Admin.

Requisiti

Prima di poter configurare AMEX nel nostro amministratore, è necessario disporre di un account attivo commerciante con loro. Durante la navigazione, AMEX vi fornirà una serie di credenziali uniche per la vostra integrazione diretta ISO.

Si prega di raccogliere i seguenti campi richiesti dal gestore di integrazione AMEX o documenti di benvenuto:

ID di affiliazione (ID merchant, SE Numero): Il tuo unico identificativo a 10 cifre per il tuo account mercantile.
Terminal ID: un codice unico che identifica un terminale specifico in una posizione Merchant.

Passi di configurazione

Collegare AMEX è una semplice configurazione a una volta nel nostro portale Admin.

Accedi al tuo portale Admin.

Navigare per Collegamenti under Payments section**,** find AMEX e selezionare Connect.

Esempio interattivoUsa dati di esempio e non effettua richieste API.

Pagamenti

Connessioni

Scopri e gestisci le integrazioni di pagamento, wallet e antifrode.

Acme LATAM · Produzione

Cerca connessioni

Connessioni	Tipo	Stato
Adyen	Gateway di pagamento	Connessa
Worldpay	Gateway di pagamento	Connessa
PayPal	Metodo di pagamento	Connessa
Mercado Pago	Metodo di pagamento	Non connessa
Riskified	Motore antifrode	Non connessa

Verrà visualizzata una forma. Inserisci con attenzione le seguenti informazioni insieme alle credenziali raccolte da AMEX e dal tuo consulente Deuna

Nome	Dettaglio
Valuta	Selezionare la valuta del processore di pagamento
Affiliation ID	Il tuo unico identificativo a 10 cifre per il tuo account mercantile ottenuto da AMEX
Inviare ID (Provied by Deuna)	Inviare ID fornito dal vostro consulente Deuna
Acquirer Afiliation ID	Utilizzare i seguenti codici a seconda della regione del tuo account commerciante: USA: 10000000002 Canada: 10000000006 Messico: 10000000005 Argentina: 10000000085 EMEA (Europa, Medio Oriente, Africa): 10000000232 Giappone: 10000000319
Terminal ID (Suggested "00000001")	Utilizzare “00001” a meno che AMEX o Deuna non consiglia un valore diverso.
Codice dati (Default "1000S0100010")	Utilizzare “1000S0100010” a meno che AMEX o Deuna consiglia un valore diverso.
Codice categoria Merchant (4 cifre)	Il vostro codice categoria 4 cifre come “4511”
Lunghezza del codice approssimativo (Default "6")	Utilizzare “6” a meno che AMEX o Deuna non consiglia un valore diverso.
Nome del commerciante	Nome commerciale Merchant
Indirizzo Merchant (strada, numero, numero interno)	Il mercante Indirizzo composto da strada, numero e interni (se applicabile).
Città del Merchant	La città dove il commerciante è registrato
Codice Postale Merchant (ad esempio "11510")	Il Codice Postale in cui i servizi sono forniti o il commerciante è registrato
Codice di Stato Merchant (3 cifre)	Il Codice di Stato 3 cifre dove i servizi sono forniti o il commerciante è registrato. Per gli Stati composti da codici a 2 cifre, è necessario aggiungere uno spazio. Esempio: Florida -> "FL "
Codice paese Merchant (numeric 3 cifre)	Il paese in cui i servizi sono forniti o il commerciante è registrato, in formato numerico a 3 cifre.
ID venditore (Solo per la modalità aggregatore. Predefinito "0000000000")	Utilizzare “0000000” a meno che AMEX o Deuna non consiglia un valore diverso.
Inviare e-mail (Solo per la modalità aggregatore. Predefinito "merchant@merchant.com")	Usare “merchant@merchant.com“A meno che AMEX o Deuna non consiglia un valore diverso.
Telefono di vendita (Solo per la modalità aggregatore. Predefinito "555555555555555"	Utilizzare “5555555555555” a meno che AMEX o Deuna consiglia un valore diverso.
Codice ragione messaggio (Default "1900")	Utilizzare “1900” a meno che AMEX o Deuna non consiglia un valore diverso.
Codice di elaborazione dell'auth ("004000" o "004800" per abilitare AAV)	Nel caso in cui si decidesse di utilizzare il servizio di verifica degli indirizzi di AMEX (AVV) utilizzare “004800”, altrimenti, utilizzare “004000”.
Verifica automatica degli indirizzi (AAV) Tipo ("AD" o "AE". Suggerito "AD")	Se hai deciso di usare AAV di AMEX: Usare "AD" (suggested) o "AE" a seconda dei tuoi requisiti: Autorizzazione, Standard (AD): viene utilizzato per inviare vari livelli di Cardmember e dati di spedizione per la verifica. Autorizzazione, Enhanced (AE): supporta tutte le funzionalità del formato AD, fornendo opzioni di verifica aggiuntive per il numero di telefono di fatturazione di Cardmember e l'email del cliente. Nel caso in cui non si utilizza AAV di AMEX, utilizzare “AD” in questo campo. ♫

Selezionare se si desidera questa connessione in una modalità Vendita (Purchase) o Pre Authorization (Autorizzazione).
Se necessario, è possibile abilitare 3DS gestiti da DEUNA per connessioni AMEX compatibili seguendo le seguenti operazioni Guida alla configurazione 3DS.
Cliccare su "Salva".
Il nostro sistema convalida le credenziali e AMEX apparirà come "Active" nella tua lista di processori collegati.

Carte di prova#

AMEX si affida a specifiche PAN e agli importi per approvare le transazioni nel loro ambiente Sandbox. Qualsiasi combinazione diversa di PAN e importo si tradurrà in una transazione negata con codici di errore generici come pick up card:

PAN	ordine.total amount (in centesimi)	Scadenza	CVV (CID)
373953192351004	52500	Qualsiasi nel futuro	Qualsiasi
373953192351004	53000	Qualsiasi nel futuro	Qualsiasi
373953192351004	56500	Qualsiasi nel futuro	Qualsiasi
373953192351004	57500	Qualsiasi nel futuro	Qualsiasi
373953192351004	58500	Qualsiasi nel futuro	Qualsiasi
373953192351004	59500	Qualsiasi nel futuro	Qualsiasi
373953192351004	61000	Qualsiasi nel futuro	Qualsiasi

Dati tecnici: ISO 8583 Autorizzazione#

La nostra integrazione utilizza la 1100 (Richiesta di autenticazione) e 1110 (Risposta di autenticazione) tipi di messaggi. Per mantenere alti tassi di approvazione e garantire il cambio di responsabilità, i seguenti campi sono obbligatori o altamente raccomandati:

Nota: Si tratta di un elenco rappresentativo dei campi più comuni utilizzati per un'autorizzazione all'e-commerce e non di una specifica esaustiva

Campo	Nome del campo	Descrizione
MTI	Tipo di messaggio Identifier	1100 Indica una richiesta di autorizzazione
Campo 2	Numero di conto primario (PAN)	Il numero di carta 16-19 cifre del cliente. Mostrato mascherato come numero di carta ID.
Campo 3	Codice di elaborazione	Indica il tipo di transazione (ad esempio, 200000 per l'acquisto).
Campo 4	Importo, Transazione	L'importo totale dell'acquisto nella valuta di transazione. E' stato mostrato in centesimi.
Campo 7	Data di trasmissione e ora	La data e l'ora della transazione è stata avviata (MMDDhh:mm:ss).
Campo d'applicazione 11	Numero di controllo della trazione di sistema (STAN)	Un numero unico di 6 cifre per identificare la transazione.
Campo 12	Transazione locale data e ora	La data e l'ora della transazione è stata avviata (YYMMDDhh:mm:ss).
Campo 14	Data di scadenza	La data di scadenza della carta in formato YYMM. - E' stato distrutto.
Campo di applicazione 19	Codice paese	Codice paese 3 cifre della transazione. - E' stato distrutto.
Campo 22	Dati POS	Per l'e-commerce, questo indica lo stato card-not-present. Aspettatevi “1000S0100010”
Campo 24	Codice funzione	Operazione codice a 3 cifre (autorizzazione, rimborso, ecc). - E' stato distrutto.
Campo 25	Codice ragione messaggio	Codice ragione messaggio ("1900"). - E' stato distrutto.
Campo 26	Codice commerciale di accettazione della carta	MCC di Merchant.
Campo 27	Codice approssimativo	Lunghezza del codice approssimativo ("6")
Campo 32	Acquirer Institution ID	Acquirente Afiliation ID. Esempio “100000000000”.
Filtra 37	Numero di riferimento Retrival	Valore unico 12 cifre per 24 ore per identificare la transazione. - E' stato distrutto.
Campo di applicazione 41	Card Acceptor Terminal ID	Il tuo ID terminale 8 cifre (TID). Esempio “00000001”
Campo 42	Codice di identificazione dell'accettatore della carta (ID merchant)	Il tuo ID Merchant da 10 cifre (dall'impostazione).
Campo 43	Luogo di ubicazione del nome dell'accettatore della carta	Nome Merchant, Nome Città Merchant definito nelle credenziali
Campo 47	Dati aggiuntivi nazionali	Fatturazione, Spedizione e dettagli di linea aerea
Campo di applicazione 48	Dati privati aggiuntivi	Indicatore di pagamento esteso American Express, che consiste del tipo di piano e del numero di installazioni. I tipi di piano sono 03 (piano di installazione), e 05 (mesi differiti): Esempio: “0306”. Può essere mostrato hashed.
Campo 49	Codice valuta, Transazione	Il codice di valuta ISO numerico a 3 cifre (ad esempio, 840 per USD). Spettacolo in vetrina
Campo di applicazione	Dati nazionali d'uso	Contiene 3D Secure 2.x e dettagli del commerciante
Campo 63	Dati personali	Contiene dati AAV

Campo 47 Dati aggiuntivi nazionali (Billing, spedizione e dettagli aerei)

Campo 47	Nome del campo	Descrizione
Subfield 0	Tipo di marca e di transazione	Concat of two digit card brand code, in case is not airlines or IAC if is airline order. “AXITD”
Sottocampo 1	(Not sent in Airline orders) CUSTOMER EMAIL ID (CE ID)	ID email cliente è costante letterale “CE”
Sottocampo 2	(Non inviato in ordini di linea aerea) CUSTOMER EMAIL	Esempio: CFFROST@EMAILADDRESS.COM
Sottocampo 3	(Not sent in Airline orders) CUSTOMER HOSTNAME ID (CHID)	ID HostName cliente è costante letterale “CH ”
Sottocampo 4	(Non inviato in ordini di linea aerea) CUSTOMER HOSTNAME.	Il dominio email del cliente. Esempio “GMAIL.COM”
Sottocampo 5	(Not sent in Airline orders) HTTP BROWSER TYPE ID (HBT ID)	HTTP Browser Type ID è costante letterale “HBT”
Sottocampo 6	(Non inviato in ordini di linea aerea) HTTP BROWSER TYPE	Agente utente dalla richiesta: Esempio: MOZILLA/4.0~(COMPATIBLE;~~MSIE~~5.0;~~WINDOWS~~95)
Sottocampo 7	(Not sent in Airline orders) SHIP TO COUNTRY ID (STC ID)	Nave a Paese ID è costante letterale “STC”
Sottocampo 8	(Non inviato in ordini di linea aerea) SHIP a PAESE	Codice paese numerico a tre cifre. Esempio 840
Sottocampo 9	(Not sent in Airline orders) SHIPPING METHOD ID (SM ID)	Metodo di spedizione ID è costante letterale “SM”
Sottocampo 10	(Non inviato in ordini di linea aerea)	Il valore per gli ordini di pick-up è “06”, altrimenti “03” (shipping options. tipo)
Sottocampo 11	(Not sent in Airline orders) MERCHANT PRODUCT SKU ID (MPS ID)	Merchant Product SKU ID è costante letterale “MPS”
Sottocampo 12	(Non inviato in ordini di linea aerea) MERCHANT PRODOTTO	SKU dell'elemento più costoso inviato nell'ordine. Nel caso in cui non venga inviato alcun SKU, il valore è "ND"
Sottocampo 13	(Non inviato in ordini di linea aerea) CUSTOMER IP	Indirizzo IP del cliente
Sottocampo 14	(Non inviato in ordini di linea aerea) CUSTOMER ANI	telefono senza “+” o spazi
Sottocampo 16	(Solo per ordini di linea aerea)	Data di partenza (formato CCYYMMDD) come “20030101”
Subfield 17	(Only for Airline orders) AIRLINE PASSENGER NAME ID (APN ID)	Nome passeggero di linea aerea ID è costante letterale “APN”
Subfield 18	(Solo per ordini di linea aerea) PASSENGER NAME	Nome del passeggero in formato: "FROST JANE M MRS"
Sottocampo 19	(Solo per ordini di linea aerea) ORIGIN (Aeroporto di origine)	Aeroporto di origine per il primo segmento di viaggio: codice IATA dell'aeroporto di origine come “SEA”
Sottocampo 20	(Solo per ordini di linea aerea) DEST	Destinazione Aeroporto per il primo segmento di viaggio: codice IATA dell'aeroporto di destinazione JFK
Sottocampo 21	(Only for Airline orders) ROUTING ID (RTG ID)	Routing ID è costante letterale “RTG”
Sottocampo 22	(Solo per ordini di linea aerea) NUMERO di CITTI	Conte di visite di città totali sia da aeroporti di origine che di destinazione.
Sottocampo 23	(Solo per ordini di linea aerea)	Codici di marcia o di città per ogni manto di gamba (incluso ORIGIN e DEST): STL / JFK / MIA
Subfield 24	(Only for Airline orders) AIRLINE CARRIERS ID (ALC ID)	Airline Carriers ID è costante letterale “ALC”
Sottocampo 25	(Solo per ordini di linea aerea) NUMERO DI CARRIERE AIRLINE	Numero di vettori aerei in viaggio
Sottocampo 26	(Solo per ordini di linea aerea)	Codice vettore aereo per ogni gamba sul biglietto (incluso ORIGIN e DEST). Esempio AB / DC / EF
Sottocampo 27	(Solo per ordini di linea aerea) FARE BASIS	“Business”
Subfield 28	(Solo per ordini di linea aerea) NUMERO DI PASSENGERS	Numero di passeggeri nel formato: 001
Sottocampo 29	(Solo per ordini di linea aerea) USTOMER IP	Indirizzo IP del cliente. Esempio 127.142.151.223
Subfield 30	(Only for Airline orders) USTOMER EMAIL ID (CE ID)	ID email cliente è costante letterale “CE”
Sottosegretario di Stato	(Only for Airline orders) USTOMER EMAIL ID	Indirizzo e-mail del cliente. Esempio:CFFROST@EMAILADDRESS.COM

Campo 61 Sottocampi chiave (3Dettagli)

Campo di applicazione	Nome del campo	Descrizione
Subfield 0	Primary and Secondary ID	Valore costante “AXASK”
Sottocampo 1	INDICATORE ELETTRONICO (ECI)	Valori di possivle: 05 = Autenticato con AEVV, 06 = Tentato con AEVV, 07 = Non autenticato
Sottocampo 2	AMERICAN EXPRESS VERIFICATION VALUE (AEVV) ID	Valore costante “AEVV”
Sottocampo 3	AMERICAN EXPRESS VERIFICATION VALUE	(AEVV) valore crittografico derivato dall'Emittente con i risultati dell'autenticazione di pagamento American ExpressSafeKey. È una base 64 a 28 caratteri, quando decodificato può mostrare informazioni chiave sull'analisi eseguita. Esempio: "AAkBAmRGkyNEM1J5EkaTAAAAAAA="
Sottocampo 4	AMERICAN EXPRESS SAFEKEY TRANSACTION ID (XID)	Valore costante “XID”
Sottocampo 5	AMERICAN EXPRESS SAFEKEY TRANSACTION ID VALUE	L'identificatore di transazione American Express SafeKey è determinato durante l'autenticazione di pagamento American Express SafeKey. Valore base64. Esempio: “AgIAADm0+B7htUfXuLAUcDlOUtM=”

Campo 63 Sottocampi chiave (dati AAV)

Campo 63	Nome del campo	Descrizione
Sottocampo 1	SERVIZIO IDENTIFIER (AX)	Costante “AX”
Sottocampo 2	REQUEST TYPE IDENTIFIER	AAV Tipo selezionato nella configurazione, sia “AD” che “AE”
Sottocampo 3	CARDMEMBER BILLING POSTAL CODE	Esempio “98107”
Sottocampo 4	CARDMEMBER BILLING ADDRESS	Esempio “6201 14TH AVE NW”
Sottocampo 5	CARDMEMBER FIRST NAME	Esempio “LEAO”
Sottocampo 6	CARDMEMBER LAST NAME	Esempio “BUTRON”
Sottocampo 7	CARDMEMBER BILLING PHONE NUMBER	Numero di telefono di fatturazione. Esempio “4155688537”
Sottocampo 8	SHIP-TO POSTAL CODE	Esempio “98107”
Sottocampo 9	SHIP-TO ADDRESS	Esempio “6201 14TH AVE NW”
Sottocampo 10	SHIP-TO FIRST NAME	Esempio “LOURDES”
Sottocampo 11	SHIP-TO LAST NAME	Esempio “MONTENEGRO”
Sottocampo 12	SHIP-TO PHONE NUMBER	Esempio “4155797662”
Sottocampo 13	SHIP-TO COUNTRY CODE	Codice paese in numero 3-digit come “840”

Sia Richiesta che Responses condividono gli stessi nomi di campo e informazioni nella maggior parte dei casi, essendo la principale differenza nel campo 38 e 39, che sono relativi ai risultati di autorizzazione:

Campo 38: autorizzazione codice o richiesta di inversione (void)
Campo 39: Le richieste di autorizzazione approvate avranno il valore “000”, e la richiesta di avversari approvati avrà il valore “400” in caso di inversione (voi). Ogni valore diverso sarà collegato a un codice di errore che verrà visualizzato nell'Amministrazione insieme alla sua descrizione.
Campo 44: codice di risultato AVS espresso in una lettera digitale. I valori possibili sono spiegati nella sezione successiva.

Risultati AVS

Quando AMEX AVS (AAV) è abilitato nella configurazione con il valore “004800”, il campo 44 restituirà il risultato AVS in lettere a una cifra, che avrà un equivalente nei codici di errore Deuna AVS:

Codice Amex AAV	Definizione	Codice Deuna AVS
Z	Solo il codice ZIP è corretto	A01
A	Solo l'indirizzo è corretto	A02
K	Solo il nome del titolare del biglietto è corretto	A03
O	Nome e indirizzo del titolare del biglietto sono corretti	A04
L'ho fatto.	Nome e codice ZIP sono corretti	A05
Y	Indirizzo e codice ZIP sono Corretto	A06
N.	Indirizzo e codice ZIP sono Errato e scorretto	A07
M	Nome, indirizzo e ZIP sono corretti	A08
E' un'altra cosa.	Nome errato, corretto indirizzo, codice ZIP corretto	A12
FF	Nome errato, corretto indirizzo, codice ZIP errato	A13
D	Nome errato, Indirizzo errato, CAP corretto	A14
W	Nome, indirizzo e codice ZIP non sono tutti errati	A15
U	Le informazioni di verifica dell'indirizzo non sono disponibili	A16
S	La verifica dell'indirizzo non è consentita	A17
R	La verifica degli indirizzi non è disponibile, Retry.	A18

Prossimo passo#

La tua connessione AMEX è ora attiva!

Il passo finale è quello di incorporarlo nel flusso di transazione. Vai al Strategia di pagamento sezione dell'Admin per costruire regole che definiscono quali transazioni sono indirizzate ad AMEX (ad esempio, "Route tutte le transazioni in EUR a AMEX").

Esempio interattivoUsa dati di esempio e non effettua richieste API.

Pagamenti

Strategie di pagamento

Configura l’elaborazione predefinita e le regole per ogni flusso di pagamento.

Acme LATAM · Produzione

Elaborazione predefinita

Configura l’elaborazione predefinita e le regole per ogni flusso di pagamento.

Regola	Instradamento	Stato	Azione
Elaborazione predefinita	Adyen → Worldpay	Attiva

Regole specifiche

Configura l’elaborazione predefinita e le regole per ogni flusso di pagamento.

Priorità	Regola	Condizioni	Instradamento	Stato
1	Ordini di importo elevato	Importo superiore a 100 USD	Adyen → Worldpay	Attiva