Pagamenti Massivi – CIT e MIT via Batch

I pagamenti Massivi permettono al merchant di sottomettere in modalità batch un insieme di transazioni CIT o MIT, senza interazione diretta con il buyer al momento dell'esecuzione.

Il flusso si basa sullo scambio di file strutturati tra il merchant e il gateway:

• il merchant produce un file di input con le transazioni da eseguire;
• il gateway elabora le richieste e restituisce un file di output con gli esiti.

Questa modalità è compatibile con i seguenti scenari:

• CIT massive – primo pagamento con carta tokenizzata (AUTHORIZATION o PURCHASE)
• MIT Recurrent massive – pagamenti ricorrenti successivi a importo e cadenza fissa
• MIT Unscheduled massive – pagamenti successivi a importo e cadenza variabile

---

Prerequisiti

Prima di sottomettere transazioni Massivi, il merchant deve disporre di:

• un token carta (PAYINSTRTOKEN) ottenuto al termine del primo pagamento E-Commerce (vedi flusso CIT COF o MIT Recurrent/Unscheduled)
• il TRACECHAINID associato alla catena di pagamenti ricorrenti, per i flussi MIT
• un TID (codice terminale) valido e configurato per operazioni batch
• le credenziali di accesso al canale batch concordate con Numia

---

File di input

Il file di input contiene una riga per ogni transazione da sottomettere. Ogni riga è composta dai campi descritti di seguito.

Campi del file di input

Campo	Descrizione	M/O	Note
V2	Versione record	M	Valore costante: V2
TRTYPE	Tipo operazione	M	A = AUTH, P = PURCHASE, D = DEBIT/CONFIRM, V = VOID/REVERSE, C = CREDIT
TID	Codice terminale	M	Codice del terminale usato per la transazione
AMOUNT	Importo transazione	M	Importo virtuale decimale (es. 100 = 1,00 EUR)
CURRENCY	Codice valuta numerico	M	Es. 978 per Euro
REFTRANID	Riferimento TranID	O	Per D o V: TRANID della fase di autorizzazione. Per C: TRANID della conferma. Per A o P: lasciare vuoto (eccetto TOPUP)
SHOPID	Chiave esterna operazione	M	Identificativo esterno dell'operazione
PAYINSTRTOKEN	Token strumento di pagamento	O	Obbligatorio per TRTYPE A o P. Deve essere un token carta valido
SHOPUSERREF	ID cliente	O	Es. indirizzo email
ADDINFO1	Campo libero merchant	O
ADDINFO2	Campo libero merchant	O
ADDINFO3	Campo libero merchant	O
ADDINFO4	Campo libero merchant	O
ADDINFO5	Campo libero merchant	O
TOPUPID	ID riferimento TopUp	O	Per A: identifica un'operazione TopUp. Per D: deve contenere il valore usato in autorizzazione
PAYMENTREASON	Causale pagamento	O
LANGID	Lingua	O	Es. IT, EN
RFU	Riservato	O
TRACECHAINID	Identificativo catena transazioni	O	Solo per TRTYPE A o P. Obbligatorio per flussi MIT Recurrent e Unscheduled
RECURRENT	Indicatore transazione ricorrente	O	Solo per TRTYPE A o P. Valori: Y, N. Deprecato: se impostato a Y, verrà usato MIT_RECURRENT_COF_NEXT come TXINDICATORTYPE
TXINDICATORTYPE	Tipo indicatore transazione	O	Solo per TRTYPE A o P. Valori ammessi: MIT_UNSCHEDULED_COF_NEXT, MIT_RECURRENT_COF_NEXT, MOTO_NOCOF, MOTO_COF_FIRST, MIT_COF_NEXT

---

File di output

Il gateway restituisce un file di output con la stessa struttura del file di input, arricchito dai campi di esito. I campi replicati dall'input sono contrassegnati come tali.

Campi del file di output

Campo	Descrizione	M/O	Note
V2	Versione record	M	Replicato dall'input
TRTYPE	Tipo operazione	M	Replicato dall'input
TID	Codice terminale	M	Replicato dall'input
AMOUNT	Importo transazione	M	Replicato dall'input
CURRENCY	Codice valuta numerico	M	Replicato dall'input
REFTRANID	Riferimento TranID	O	Replicato dall'input
SHOPID	Chiave esterna operazione	M	Replicato dall'input
PAYINSTRTOKEN	Token strumento di pagamento	O	Replicato dall'input
RC	Codice risposta		Codice esito. Vedere Appendice C – Response Code
DESC	Descrizione codice risposta		Descrizione dell'esito. In caso di errore fornisce informazioni aggiuntive
TRANID	TranID		Riferimento alla transazione elaborata. Presente solo in caso di esito positivo
SHOPUSERREF	ID cliente	O	Replicato dall'input
ADDINFO1	Campo libero merchant	O	Replicato dall'input
ADDINFO2	Campo libero merchant	O	Replicato dall'input
ADDINFO3	Campo libero merchant	O	Replicato dall'input
ADDINFO4	Campo libero merchant	O	Replicato dall'input
ADDINFO5	Campo libero merchant	O	Replicato dall'input
TOPUPID	ID riferimento TopUp	O	Replicato dall'input
PAYMENTREASON	Causale pagamento	O	Replicato dall'input
LANGID	Lingua	O	Replicato dall'input
RFU	Riservato	O	Replicato dall'input
TRACECHAINID	Identificativo catena transazioni	O	Replicato dall'input
RECURRENT	Indicatore transazione ricorrente	O	Replicato dall'input
TXINDICATORTYPE	Tipo indicatore transazione	O	Replicato dall'input

---

Scenari supportati

CIT massive

Il flusso CIT massive consente di sottomettere in batch un primo pagamento con carta tokenizzata, in modalità AUTHORIZATION (A) o PURCHASE (P).

Configurazione richiesta nel file di input:

• TRTYPE = A o P
• PAYINSTRTOKEN = token carta valido ottenuto dal primo pagamento E-Commerce
• TXINDICATORTYPE non valorizzato oppure impostato a MOTO_COF_FIRST

Questo scenario è utile quando il merchant vuole autorizzare o addebitare una carta già tokenizzata senza interazione con il buyer.

---

MIT Recurrent massive

Il flusso MIT Recurrent massive consente di eseguire in batch i pagamenti ricorrenti successivi al primo, con importo e cadenza fissa.

Prerequisiti:

• il primo pagamento E-Commerce deve essere stato eseguito con txIndicatorType = CIT_RECURRENT_COF_FIRST
• il merchant deve aver conservato il TRACECHAINID usato nella prima transazione

Configurazione richiesta nel file di input:

• TRTYPE = A o P
• PAYINSTRTOKEN = token carta valido
• TRACECHAINID = identificativo usato nella prima transazione ricorrente
• TXINDICATORTYPE = MIT_RECURRENT_COF_NEXT

Il campo RECURRENT è deprecato. Si raccomanda di usare TXINDICATORTYPE = MIT_RECURRENT_COF_NEXT in tutti i nuovi sviluppi.

---

MIT Unscheduled massive

Il flusso MIT Unscheduled massive consente di eseguire in batch pagamenti successivi con importo e cadenza variabili.

Prerequisiti:

• il primo pagamento E-Commerce deve essere stato eseguito con txIndicatorType = CIT_UNSCHEDULED_COF_FIRST
• il merchant deve aver conservato il TRACECHAINID usato nella prima transazione

Configurazione richiesta nel file di input:

• TRTYPE = A o P
• PAYINSTRTOKEN = token carta valido
• TRACECHAINID = identificativo usato nella prima transazione Unscheduled
• TXINDICATORTYPE = MIT_UNSCHEDULED_COF_NEXT

---

Note operative

• Il campo RECURRENT è deprecato: se impostato a Y, il gateway utilizzerà automaticamente MIT_RECURRENT_COF_NEXT come TXINDICATORTYPE. Si raccomanda di impostare esplicitamente TXINDICATORTYPE in tutti i nuovi sviluppi.
• I campi TRACECHAINID e TXINDICATORTYPE sono obbligatori per tutti i flussi MIT; la loro assenza può causare il rifiuto della transazione.
• Il TRANID presente nel file di output è necessario per eventuali operazioni successive di conferma (D) o storno (V).
• Per i codici di risposta (RC) fare riferimento all'Appendice C – Response Code della documentazione Numia.