Introduzione
La funzione Bulk Upload (Caricamento massivo) consente di effettuare conversioni e pagamenti massivi tramite Currencycloud Direct. Per farlo, occorre caricare un file (.csv) contenente informazioni su pagamenti, conversioni e/o beneficiari utilizzando l’interfaccia dell’applicazione.
Per ulteriori informazioni, continua a leggere. In caso di domande, invia un’email a support@currencycloud.com o contatta il Relationship Manager di riferimento.
Procedura di caricamento massivo
Un caricamento massivo inizia con la selezione del file necessario. Dopo aver verificato che il formato sia corretto (.csv) e che contenga tutte le informazioni relative ai pagamenti e alle conversioni, il file viene elaborato e i pagamenti e le conversioni vengono eseguite. Puoi consultare la cronologia relativa ai caricamenti massivi accedendo all’interfaccia utente dell’applicazione Currencycloud Direct.
Formato del file per il caricamento massivo
Il formato del file utilizzato per il caricamento massivo di pagamenti e/o conversioni è il CSV. La prima riga del file CSV deve contenere le intestazioni dei vari campi presenti nel documento. La sezione Formato del file riporta tutti i valori, e le relative intestazioni, che possono essere forniti tramite il caricamento del file. Tieni presente che le intestazioni sono necessarie per garantire la corretta elaborazione del file, pertanto devono essere scritte esattamente come quelle indicate. In caso contrario, si verifica un errore di convalida che non consente di procedere con l’elaborazione. Ogni riga del file può contenere una conversione, un pagamento, un pagatore, un beneficiario o una combinazione di questi elementi. Nota: se crei/modifichi il file con Microsoft Excel, assicurati che tutti i campi siano formattati come “Testo” per evitare un’eventuale formattazione automatica dei numeri con un conseguente errore di convalida.
Esempi di file .CSV
- Scarica CSV di esempio (file completo, 45 colonne)
- Scarica CSV di esempio (l’ordinante del pagamento è l’utente, 29 colonne)
- Scarica CSV di esempio (nuovo beneficiario con riferimento esterno, 23 colonne)
- Scarica CSV di esempio (pagamento a favore di un beneficiario con riferimento esterno, 8 colonne)
- Scarica CSV di esempio (file di conversione, 6 colonne)
- Scarica CSV di esempio (conversione e pagamento a favore di un beneficiario con riferimento esterno, 10 colonne)
Identificazione e aggiornamento di un beneficiario
Durante il caricamento di pagamenti, possono essere indicati i beneficiari già presenti nel sistema. Per rimandare al beneficiario corretto, usa il campo beneficiary_external_reference. Il valore deve essere un riferimento noto, ad esempio il riferimento/l’ID del beneficiario che usi sul tuo sistema o sulla tua piattaforma.
Quando effettui un pagamento a favore di un beneficiario per la prima volta, aggiungi al file CSV il riferimento del beneficiario esterno e tutti i relativi dettagli. I pagamenti successivi richiederanno solo il valore relativo al riferimento del beneficiario esterno. Per questo motivo è importante che il valore di beneficiary_external_reference utilizzato sia associato esclusivamente a un determinato beneficiario.
Per aggiornare i dettagli di un beneficiario, fornisci il valore di beneficiary_external_reference insieme ai nuovi valori relativi ai campi da aggiornare. Ricorda che occorre correggere solo questi ultimi. Ad esempio, se il numero del conto corrente di un beneficiario è cambiato, gli unici due campi da modificare per aggiornarlo sono “external beneficiary reference” e “new account number”. Se questi valori vengono forniti insieme alle istruzioni di pagamento, prima viene aggiornato il beneficiario e poi viene effettuato il pagamento in base ai dettagli aggiornati.
Schermata principale della funzione Bulk upload
Questa schermata riporta la cronologia dei caricamenti massivi e lo stato di quelli precedenti. Puoi filtrare l’elenco dei caricamenti massivi esistenti o cercarne uno specifico utilizzando l’apposita funzione.
Una volta trovato il caricamento desiderato, clicca sul relativo Reference ID (ID riferimento) per visualizzare i dettagli dell’operazione o l’elenco degli errori di convalida, a seconda dello stato del caricamento massivo.
Per iniziare a caricare un file contenente pagamenti e/o conversioni, accedi alla schermata principale di “Bulk Upload” (Caricamento massivo), quindi clicca sul pulsante “Upload File” (Carica file).
Selezione del file da caricare
Per iniziare a caricare un nuovo file, accedi alla scheda “Upload File” (Carica file). Trascina e rilascia il file sull’area designata della schermata o clicca sul link “Browse” (Cerca) per cercare il file da caricare.
Dopo aver caricato il file, inizia la procedura di convalida.
Convalida del file
La procedura di convalida inizia subito dopo la selezione del file da caricare. In seguito, compare una schermata con le informazioni relative allo stato di avanzamento della procedura, ma puoi uscire da questa pagina e recuperarla in un secondo momento. Una volta completata la procedura di convalida, ricevi una notifica email con il risultato dell’operazione (convalida completata o non riuscita). A questo punto, puoi tornare alla schermata principale “Bulk Upload”, selezionare il caricamento massivo corrispondente dall’elenco e visualizzare il risultato della procedura di convalida (completata o non riuscita).
Se si verificano errori di convalida, consulta il relativo elenco e le informazioni su come risolverli. Queste informazioni ti aiuteranno ad aggiornare il file e a ricaricarlo sulla piattaforma per la convalida. Se non si verificano errori, clicca sul pulsante “Process File” (Elabora file) per procedere con l’elaborazione del file. A questo punto, compare una schermata con la panoramica dei contenuti del file.
Elaborazione del file
Dopo aver cliccato sul pulsante “Process File” (Elabora file), il file viene inviato e compare una schermata con lo stato di avanzamento dell’operazione. Puoi uscire da questa pagina e tornare alla schermata principale “Bulk Upload” per controllare lo stato di elaborazione del file. Una volta completata l’elaborazione, ricevi una notifica email con il risultato.
Formato del file
| Intestazione | Descrizione | Condizioni |
|---|---|---|
| to_amount | Se conosci l’importo esatto da destinare al beneficiario, inserisci un valore in questo campo | Numero, può contenere due cifre decimali. Se non specifichi il valore di to_amount, indica quello di from_amount. Non specificare entrambi |
| to_currency | La valuta in cui desideri che il beneficiario riceva il pagamento | Codice di 3 caratteri nello standard internazionale ISO 4217 |
| from_amount | Se conosci l’importo esatto da inviare e convertire nella valuta indicata in to_currency, fornisci un valore in questo campo | Numero, può contenere fino a due cifre decimali. Se non specifichi il valore di from_amount, indica quello di to_amount. Non specificare entrambi |
| from_currency | La valuta da cui desideri effettuare la conversione | Codice di 3 caratteri nello standard internazionale ISO 4217 |
| delivery_date | La data in cui desideri che il pagamento venga elaborato e inviato al beneficiario | Campo per la data nel formato ISO 8601 (AAAA-MM-GG). Obbligatorio per i pagamenti e le conversioni |
| bank_account_holder_name | Il nome esatto del beneficiario indicato sul conto corrente a cui inviare il pagamento. Attenzione: se non coincide con il nome registrato dalla banca, quest’ultima potrebbe rifiutare il pagamento | Fino a 50 caratteri. Obbligatorio per i pagamenti |
| destination_country_code | Il Paese del conto corrente su cui inviare il pagamento | Codice di 2 caratteri nello standard internazionale |
| payment_type | Puoi effettuare un pagamento “prioritario”, veloce e più costoso, o “standard”, meno rapido ma più economico. Il valore di questo campo deve essere “priority” o “regular” | Campo con opzione “priority” o “regular”. Obbligatorio per i pagamenti |
| charge_type | Se scegli il pagamento prioritario (payment_type=priority), a seconda della configurazione del conto, puoi aggiungere le commissioni di tipo “Ours” o “Shared”. L’opzione “Ours” comporta un costo superiore per il pagamento, ma consente al beneficiario di ricevere l’importo per intero. L’opzione “Shared”, invece, comporta costi inferiori, ma eventuali commissioni vengono dedotte dall’importo del pagamento, quindi quest’ultimo potrebbe non arrivare per intero sul conto del beneficiario | Campo con opzione “Shared” o “Ours”. Facoltativo per i pagamenti prioritari |
| purpose_code | Quando crei un pagamento transfrontaliero, la banca centrale del Paese potrebbe richiedere di aggiungere un codice causale alla transazione al fine dell’accettazione e dell’elaborazione del pagamento | Se è necessario aggiungere un codice causale di pagamento ma questo non viene fornito, la transazione potrebbe subire un ritardo o venire rifiutata dalla banca beneficiaria. Obbligatorio per determinate valute e nazioni |
| payment_unique_request_id | ID univoco relativo al pagamento definito dall’utente. Campo obbligatorio per garantire che non vengano effettuati pagamenti identici | Campo obbligatorio, può contenere fino a 255 caratteri |
| reference | Il riferimento del pagamento che potrebbe essere fornito al beneficiario, salvo restrizioni della rete bancaria | Può contenere fino a 50 caratteri alfanumerici, ma l’uso di questo formato dipende dalla rete bancaria nel Paese di destinazione. Obbligatorio per i pagamenti |
| reason | La causale del pagamento | Può contenere fino a 50 caratteri alfanumerici. Obbligatorio per i pagamenti e le conversioni |
| bic_swift | Identificativo bancario utilizzato in tutto il mondo | Codice di 8 o 11 caratteri obbligatorio per la maggior parte dei pagamenti standard |
| account_number | Il numero del conto corrente del beneficiario | Campo condizionale |
| iban | Il numero del conto corrente internazionale (utilizzato principalmente in Europa) | Fino a 32 caratteri alfanumerici |
| aba | ABA number (utilizzato solo negli Stati Uniti) | Numero di 9 cifre obbligatorio per i pagamenti standard verso gli Stati Uniti |
| bank_code | Codice identificativo bancario utilizzato per i pagamenti standard | Numero di 4 cifre obbligatorio per i pagamenti standard verso Singapore, Danimarca e Svezia
OPPURE Numero di 4-5 cifre obbligatorio per i pagamenti standard verso la Norvegia OPPURE Numero di 3 cifre obbligatorio per i pagamenti standard verso il Canada |
| branch_code | Codice identificativo bancario utilizzato per i pagamenti standard | Numero di 3 cifre obbligatorio per i pagamenti standard verso Singapore
OPPURE Numero di 5 cifre obbligatorio per i pagamenti standard verso il Canada |
| sort_code | Codice identificativo bancario utilizzato per i pagamenti standard | Numero di 6 cifre obbligatorio per i pagamenti locali verso il Regno Unito |
| bank_name | Il nome della banca che riceve i fondi | L’inserimento del nome avviene automaticamente se il campo bic_swift, IBAN, aba o sort_code è specificato, altrimenti deve essere inserito nel file |
| bank_account_type | Identifica il tipo di conto corrente | Obbligatorio solo per i pagamenti standard in USD verso gli Stati Uniti. Può essere di tipo “Checking” (Conto corrente) o “Savings” (Conto di risparmio) |
| beneficiary_external_reference | Il riferimento del beneficiario a te noto, ad esempio il riferimento/l’ID del beneficiario che usi sul tuo sistema o sulla tua piattaforma esterna | Stringa obbligatoria se effettui un pagamento a favore di un beneficiario esistente OPPURE se desideri aggiornare i dati di un beneficiario esistente |
| beneficiary_type | Identifica il tipo di beneficiario. La scelta determina il tipo di nome riportato di seguito | Può essere “Company” (Azienda) o “Individual” (Persona fisica) |
| beneficiary_company_name | La ragione sociale dell’azienda | Stringa, può contenere fino a 50 caratteri. Obbligatoria se scegli “Company” (Azienda) per il campo beneficiary_type |
| beneficiary_first_name | Il nome della persona fisica | Stringa, può contenere fino a 50 caratteri. Obbligatoria se scegli “Individual” (Persona fisica) per il campo beneficiary_type |
| beneficiary_last_name | Il cognome della persona fisica | Stringa, può contenere fino a 50 caratteri. Obbligatoria se scegli “Individual” (Persona fisica) per il campo beneficiary_type |
| beneficiary_address | Prima riga dell’indirizzo, compreso il numero o il nome dell’edificio | Stringa, può contenere fino a 50 caratteri. Indica l’indirizzo della sede legale dell’azienda o la residenza principale della persona fisica che riceve il pagamento
|
| beneficiary_city | La città in cui si trova l’indirizzo del beneficiario | Stringa, può contenere fino a 50 caratteri |
| beneficiary_postcode | Il codice postale dell’indirizzo del beneficiario | Stringa obbligatoria per alcuni Paesi (Stati Uniti, Messico o Canada) |
| beneficiary_state_or_province | Lo stato o la provincia in cui si trova l’indirizzo del beneficiario | Stringa obbligatoria per alcuni Paesi (Stati Uniti, Messico o Canada) |
| beneficiary_country | Il codice del Paese in cui si trova l’indirizzo del beneficiario | 2 caratteri nel formato ISO 3166-1 alpha-2 |
| payer_type | Identifica il tipo di pagatore. La scelta determina il tipo di nome riportato di seguito | Può essere “Company” (Azienda) o “Individual” (Persona fisica) |
| payer_company_name | La ragione sociale dell’azienda | Stringa, può contenere fino a 50 caratteri. Obbligatoria se scegli “Company” (Azienda) per il campo payer_type |
| payer_first_name | Il nome della persona fisica | Stringa, può contenere fino a 50 caratteri. Obbligatoria se scegli “Individual” (Persona fisica) per il campo payer_type |
| payer_last_name | Il cognome della persona fisica | Stringa, può contenere fino a 50 caratteri. Obbligatoria se scegli “Individual” (Persona fisica) per il campo payer_type |
| payer_address | Prima riga dell’indirizzo, compreso il numero o il nome dell’edificio. Deve indicare l’indirizzo della sede legale dell’azienda o la residenza principale della persona fisica che effettua il pagamento | Stringa, può contenere fino a 50 caratteri |
| payer_city | La città in cui si trova l’indirizzo del pagatore | Stringa, può contenere fino a 50 caratteri |
| payer_postcode | Il codice postale dell’indirizzo del pagatore | Stringa obbligatoria per alcuni Paesi (Stati Uniti, Messico o Canada) |
| payer_state_or_province | Lo stato o la provincia in cui si trova l’indirizzo del pagatore | Stringa obbligatoria per alcuni Paesi (Stati Uniti, Messico o Canada) |
| payer_country | Il codice del Paese in cui si trova l’indirizzo del pagatore | Codice Paese ISO di 2 caratteri |
| payer_date_of_birth | Se il pagatore è una persona fisica, questo campo indica la sua data di nascita | Campo obbligatorio per la data nel formato ISO 8601 (AAAA-MM-GG) |
| payer_identification_type | Se il pagatore è un’azienda e il pagamento è di tipo prioritario, il campo payer_identification_type è obbligatorio e deve essere impostato su incorporation_number | Può contenere fino a 50 caratteri alfanumerici |
| payer_identification_value | Se il campo payer_identification_type è impostato su incorporation_number, questo valore indica il numero di iscrizione al registro delle imprese | Può contenere fino a 50 caratteri alfanumerici |
Campi relativi ai beneficiari per Paese
Di seguito sono riportati i campi relativi ai beneficiari necessari per ciascun tipo di pagamento e poi per ogni Paese (in ordine alfabetico). Per ulteriori informazioni sui requisiti di pagamento, consulta le Guide ai pagamenti.
Pagamenti prioritari
Se desideri che il pagamento arrivi al beneficiario nel più breve tempo possibile e non badi ai costi di un bonifico bancario internazionale, effettua un pagamento prioritario.
I campi relativi al beneficiario necessari per i pagamenti prioritari sono i seguenti:
- Per i pagamenti in GBP verso il Regno Unito (incluse Jersey, Guernsey e Isola di Man), fornisci account_number e sort_code
- Per i pagamenti verso gli Stati Uniti, fornisci account_number e aba o account_number e bic_swift
- Per i Paesi che utilizzano l’IBAN (tutti quelli europei e altre nazioni specifiche, clicca sul link riportato di seguito), fornisci i campi IBAN e bic_swift
- Per tutti gli altri tipi di pagamento standard, fornisci account_number e bic_swift
Elenco dei Paesi che utilizzano l’IBAN (PDF)
Tutti i pagamenti prioritari devono includere le seguenti informazioni sul pagatore e sul beneficiario:
| Campo | Descrizione | Condizioni |
|---|---|---|
| beneficiary_type | Identifica il tipo di beneficiario. La scelta determina il tipo di nome riportato di seguito | Può essere “Company” (Azienda) o “Individual” (Persona fisica) |
| beneficiary_company_name | La ragione sociale dell’azienda | Stringa obbligatoria se scegli “Company” (Azienda) per il campo beneficiary_type |
| beneficiary_first_name | Il nome della persona fisica | Stringa obbligatoria se scegli “Individual” (Persona fisica) per il campo beneficiary_type |
| beneficiary_last_name | Il cognome della persona fisica | Stringa obbligatoria se scegli “Individual” (Persona fisica) per il campo beneficiary_type |
| beneficiary_address | Prima riga dell’indirizzo, compreso il numero o il nome dell’edificio. Deve indicare l’indirizzo della sede legale dell’azienda o la residenza principale della persona fisica che riceve il pagamento | |
| beneficiary_city | La città in cui si trova l’indirizzo del beneficiario | Stringa obbligatoria se è impostato il campo beneficiary_type |
| beneficiary_postcode | Il codice postale dell’indirizzo del beneficiario | Stringa obbligatoria per alcuni Paesi (Stati Uniti, Messico o Canada) e se è impostato il campo beneficiary_type |
| beneficiary_state_or_province | Lo stato o la provincia in cui si trova l’indirizzo del beneficiario | Stringa obbligatoria per alcuni Paesi (Stati Uniti, Messico o Canada) e se è impostato il campo beneficiary_type |
| beneficiary_country | Il codice del Paese in cui si trova l’indirizzo del beneficiario | Codice Paese ISO di 2 caratteri. Obbligatorio se è impostato il campo beneficiary_type |
| payer_type | Identifica il tipo di pagatore. La scelta determina il tipo di nome riportato di seguito | Può essere “Company” (Azienda) o “Individual” (Persona fisica) |
| payer_company_name | La ragione sociale dell’azienda | Stringa obbligatoria se scegli “Company” (Azienda) per il campo payer_type |
| payer_first_name | Il nome della persona fisica | Stringa obbligatoria se scegli “Individual” (Persona fisica) per il campo payer_type |
| payer_last_name | Il cognome della persona fisica | Stringa obbligatoria se scegli “Individual” (Persona fisica) per il campo payer_type |
| payer_address | Prima riga dell’indirizzo, compreso il numero o il nome dell’edificio. Deve indicare l’indirizzo della sede legale dell’azienda o la residenza principale della persona fisica che effettua il pagamento | |
| payer_city | La città in cui si trova l’indirizzo del pagatore | Stringa obbligatoria se è impostato il campo payer_type |
| payer_postcode | Il codice postale dell’indirizzo del pagatore | Stringa obbligatoria per alcuni Paesi (Stati Uniti, Messico o Canada) e se è impostato il campo payer_type |
| payer_state_or_province | Lo stato o la provincia in cui si trova l’indirizzo del pagatore | Stringa obbligatoria per alcuni Paesi (Stati Uniti, Messico o Canada) e se è impostato il campo payer_type |
| payer_country | Il codice del Paese in cui si trova l’indirizzo del pagatore | Codice Paese ISO di 2 caratteri. Obbligatorio se è impostato il campo payer_type |
| payer_date_of_birth | Se il pagatore è una persona fisica, questo campo indica la sua data di nascita | Campo obbligatorio per la data nel formato ISO 8601 (AAAA-MM-GG) |
| payer_identification_type | Se il pagatore è un’azienda e il pagamento è di tipo prioritario, il campo payer_identification_type è obbligatorio e deve essere impostato su incorporation_number | Può contenere fino a 50 caratteri alfanumerici |
| payer_identification_value | Se il campo payer_identification_type è impostato su incorporation_number, questo valore indica il numero di iscrizione al registro delle imprese | Può contenere fino a 50 caratteri alfanumerici |
Pagamenti prioritari negli Emirati Arabi Uniti
È obbligatorio aggiungere il codice causale di pagamento. Se non viene fornito, il pagamento potrebbe subire un ritardo o venire rifiutato dalla banca beneficiaria.
| Campo | Descrizione | Condizioni |
|---|---|---|
| purpose_code | Quando crei un pagamento transfrontaliero, la banca centrale del Paese potrebbe richiedere di aggiungere un codice causale alla transazione al fine dell’accettazione e dell’elaborazione del pagamento |
Pagamenti locali standard
Se desideri inviare fondi utilizzando un metodo più economico e assicurarti che l’importo arrivi per intero al beneficiario, effettua un pagamento standard.
Di seguito sono riportati i campi relativi ai beneficiari necessari per ciascun Paese di destinazione verso cui Currencycloud consente di inviare pagamenti standard. Questi campi si aggiungono a quelli obbligatori indicati nella tabella Formato del file riportata in precedenza, qui omessi per brevità.
Pagamenti standard in Australia
| Campo | Descrizione | Condizioni |
|---|---|---|
| to_currency | La valuta in cui desideri che il beneficiario riceva il pagamento | AUD |
| account_number | Il numero del conto corrente del beneficiario | Obbligatorio, può contenere da 5 a 20 caratteri |
| bsb_code | L’identificativo della filiale della banca utilizzato in Australia | Numero obbligatorio di 6 cifre |
Pagamenti standard in Austria
| Campo | Descrizione | Condizioni |
|---|---|---|
| to_currency | La valuta in cui desideri che il beneficiario riceva il pagamento | EUR |
| iban | Il numero del conto corrente internazionale (utilizzato principalmente in Europa) | Codice obbligatorio di 20 caratteri alfanumerici |
| bic_swift | Identificativo bancario utilizzato in tutto il mondo | Codice obbligatorio di 8 o 11 caratteri |
Pagamenti standard in Belgio
| Campo | Descrizione | Condizioni |
|---|---|---|
| to_currency | La valuta in cui desideri che il beneficiario riceva il pagamento | EUR |
| iban | Il numero del conto corrente internazionale (utilizzato principalmente in Europa) | Codice obbligatorio di 16 caratteri alfanumerici |
| bic_swift | Identificativo bancario utilizzato in tutto il mondo | Codice obbligatorio di 8 o 11 caratteri |
Pagamenti standard a Cipro
| Campo | Descrizione | Condizioni |
|---|---|---|
| to_currency | La valuta in cui desideri che il beneficiario riceva il pagamento | EUR |
| iban | Il numero del conto corrente internazionale (utilizzato principalmente in Europa) | Codice obbligatorio di 28 caratteri alfanumerici |
| bic_swift | Identificativo bancario utilizzato in tutto il mondo | Codice obbligatorio di 8 o 11 caratteri |
Pagamenti standard nella Repubblica Ceca
| Campo | Descrizione | Condizioni |
|---|---|---|
| to_currency | La valuta in cui desideri che il beneficiario riceva il pagamento | CZK |
| iban | Il numero del conto corrente internazionale (utilizzato principalmente in Europa) | Codice obbligatorio di 24 caratteri alfanumerici |
| bic_swift | Identificativo bancario utilizzato in tutto il mondo | Codice obbligatorio di 8 o 11 caratteri |
Pagamenti standard in Danimarca
| Campo | Descrizione | Condizioni |
|---|---|---|
| to_currency | La valuta in cui desideri che il beneficiario riceva il pagamento | DKK |
| account_number | Numero del conto corrente del beneficiario | 4-10 cifre |
| bank_code | Codice della banca beneficiaria | 4 cifre |
Pagamenti standard in Estonia
| Campo | Descrizione | Condizioni |
|---|---|---|
| to_currency | La valuta in cui desideri che il beneficiario riceva il pagamento | EUR |
| iban | Il numero del conto corrente internazionale (utilizzato principalmente in Europa) | Codice obbligatorio di 20 caratteri alfanumerici |
| bic_swift | Identificativo bancario utilizzato in tutto il mondo | Codice obbligatorio di 8 o 11 caratteri |
Pagamenti standard in Finlandia
| Campo | Descrizione | Condizioni |
|---|---|---|
| to_currency | La valuta in cui desideri che il beneficiario riceva il pagamento | EUR |
| iban | Il numero del conto corrente internazionale (utilizzato principalmente in Europa) | Codice obbligatorio di 18 caratteri alfanumerici |
| bic_swift | Identificativo bancario utilizzato in tutto il mondo | Codice obbligatorio di 8 o 11 caratteri |
Pagamenti standard in Francia
| Campo | Descrizione | Condizioni |
|---|---|---|
| to_currency | La valuta in cui desideri che il beneficiario riceva il pagamento | EUR |
| iban | Il numero del conto corrente internazionale (utilizzato principalmente in Europa) | Codice obbligatorio di 27 caratteri alfanumerici |
| bic_swift | Identificativo bancario utilizzato in tutto il mondo | Codice obbligatorio di 8 o 11 caratteri |
Pagamenti standard in Germania
| Campo | Descrizione | Condizioni |
|---|---|---|
| to_currency | La valuta in cui desideri che il beneficiario riceva il pagamento | EUR |
| iban | Il numero del conto corrente internazionale (utilizzato principalmente in Europa) | Codice obbligatorio di 22 caratteri alfanumerici |
| bic_swift | Identificativo bancario utilizzato in tutto il mondo | Codice obbligatorio di 8 o 11 caratteri |
Pagamenti standard in Grecia
| Campo | Descrizione | Condizioni |
|---|---|---|
| to_currency | La valuta in cui desideri che il beneficiario riceva il pagamento | EUR |
| iban | Il numero del conto corrente internazionale (utilizzato principalmente in Europa) | Codice obbligatorio di 27 caratteri alfanumerici |
| bic_swift | Identificativo bancario utilizzato in tutto il mondo | Codice obbligatorio di 8 o 11 caratteri |
Pagamenti standard a Hong Kong
| Campo | Descrizione | Condizioni |
|---|---|---|
| to_currency | La valuta in cui desideri che il beneficiario riceva il pagamento | HKD |
| account_number | Il numero del conto corrente del beneficiario | Numero obbligatorio di 9-11 cifre, può includere il codice della filiale (branch_code) |
| bank_name | Il nome della banca che riceve i fondi | Obbligatorio, può contenere fino a 34 caratteri |
| bic_swift | Identificativo bancario utilizzato in tutto il mondo | Codice obbligatorio di 8 o 11 caratteri |
Pagamenti standard in Ungheria
| Campo | Descrizione | Condizioni |
|---|---|---|
| to_currency | La valuta in cui desideri che il beneficiario riceva il pagamento | HUF |
| iban | Il numero del conto corrente internazionale (utilizzato principalmente in Europa) | Codice obbligatorio di 24 caratteri alfanumerici |
| bic_swift | Identificativo bancario utilizzato in tutto il mondo | Codice obbligatorio di 8 o 11 caratteri |
Pagamenti standard in India
| Campo | Descrizione | Condizioni |
|---|---|---|
| to_currency | La valuta in cui desideri che il beneficiario riceva il pagamento | INR |
| account_number | Il numero del conto corrente del beneficiario |
10-20 cifre (per i pagamenti fino a 200.000 INR) |
| bank_name | Il nome della banca che riceve i fondi |
1-49 caratteri alfanumerici (spazi consentiti) |
| ifsc | Indian Financial System Code. È un codice di 11 caratteri alfanumerici che identifica in modo univoco la filiale di una banca |
4 lettere seguite da 7 caratteri alfanumerici |
| purpose_code | Codice causale di pagamento valido |
I codici validi sono indicati in questo articolo: |
Pagamenti standard in Indonesia
| Campo | Descrizione | Condizioni | ||
|---|---|---|---|---|
| to_currency | La valuta in cui desideri che il beneficiario riceva il pagamento | IDR | ||
| account_number | Il numero del conto corrente del beneficiario |
1-20 cifre |
||
| bank_name | Il nome della banca che riceve i fondi | bic_swift | Identificativo bancario utilizzato in tutto il mondo | 8 o 11 caratteri |
Pagamenti standard in Irlanda
| Campo | Descrizione | Condizioni |
|---|---|---|
| to_currency | La valuta in cui desideri che il beneficiario riceva il pagamento | EUR |
| iban | Il numero del conto corrente internazionale (utilizzato principalmente in Europa) | Codice obbligatorio di 22 caratteri alfanumerici |
| bic_swift | Identificativo bancario utilizzato in tutto il mondo | Codice obbligatorio di 8 o 11 caratteri |
Pagamenti standard in Italia
| Campo | Descrizione | Condizioni |
|---|---|---|
| to_currency | La valuta in cui desideri che il beneficiario riceva il pagamento | EUR |
| iban | Il numero del conto corrente internazionale (utilizzato principalmente in Europa) | Codice obbligatorio di 27 caratteri alfanumerici |
| bic_swift | Identificativo bancario utilizzato in tutto il mondo | Codice obbligatorio di 8 o 11 caratteri |
Pagamenti standard nel Lussemburgo
| Campo | Descrizione | Condizioni |
|---|---|---|
| to_currency | La valuta in cui desideri che il beneficiario riceva il pagamento | EUR |
| iban | Il numero del conto corrente internazionale (utilizzato principalmente in Europa) | Codice obbligatorio di 20 caratteri alfanumerici |
| bic_swift | Identificativo bancario utilizzato in tutto il mondo | Codice obbligatorio di 8 o 11 caratteri |
Pagamenti standard in Malesia
| Campo | Descrizione | Condizioni |
|---|---|---|
| to_currency | La valuta in cui desideri che il beneficiario riceva il pagamento | MYR |
| account_number | Il numero del conto corrente del beneficiario | 1-16 cifre |
| bic_swift | Identificativo bancario utilizzato in tutto il mondo | Codice obbligatorio di 8 o 11 caratteri |
| purpose_code | Codice causale di pagamento valido |
I codici validi sono indicati in questo articolo: |
Pagamenti standard a Malta
| Campo | Descrizione | Condizioni |
|---|---|---|
| to_currency | La valuta in cui desideri che il beneficiario riceva il pagamento | EUR |
| iban | Il numero del conto corrente internazionale (utilizzato principalmente in Europa) | Codice obbligatorio di 31 caratteri alfanumerici |
| bic_swift | Identificativo bancario utilizzato in tutto il mondo | Codice obbligatorio di 8 o 11 caratteri |
Pagamenti standard nei Paesi Bassi
| Campo | Descrizione | Condizioni |
|---|---|---|
| to_currency | La valuta in cui desideri che il beneficiario riceva il pagamento | EUR |
| iban | Il numero del conto corrente internazionale (utilizzato principalmente in Europa) | Codice obbligatorio di 18 caratteri alfanumerici |
| bic_swift | Identificativo bancario utilizzato in tutto il mondo | Codice obbligatorio di 8 o 11 caratteri |
Pagamenti standard in Norvegia
| Campo | Descrizione | Condizioni |
|---|---|---|
| to_currency | La valuta in cui desideri che il beneficiario riceva il pagamento | NOK |
| account_number | Numero del conto corrente del beneficiario | 7 cifre |
| bank_code | Codice della banca beneficiaria | 4 cifre |
Pagamenti standard nelle Filippine
| Campo | Descrizione | Condizioni |
|---|---|---|
| to_currency | La valuta in cui desideri che il beneficiario riceva il pagamento | PHP |
| account_number | Numero del conto corrente del beneficiario | 1-17 cifre |
| bic_swift | Identificativo bancario utilizzato in tutto il mondo | 8 o 11 caratteri alfanumerici |
Pagamenti standard in Polonia
| Campo | Descrizione | Condizioni |
|---|---|---|
| to_currency | La valuta in cui desideri che il beneficiario riceva il pagamento | PLN |
| iban | Il numero del conto corrente internazionale (utilizzato principalmente in Europa) | Codice obbligatorio di 28 caratteri alfanumerici |
| bic_swift | Identificativo bancario utilizzato in tutto il mondo | Codice obbligatorio di 8 o 11 caratteri |
Pagamenti standard in Portogallo
| Campo | Descrizione | Condizioni |
|---|---|---|
| to_currency | La valuta in cui desideri che il beneficiario riceva il pagamento | EUR |
| iban | Il numero del conto corrente internazionale (utilizzato principalmente in Europa) | Codice obbligatorio di 25 caratteri alfanumerici |
| bic_swift | Identificativo bancario utilizzato in tutto il mondo | Codice obbligatorio di 8 o 11 caratteri |
Pagamenti standard a Singapore
| Campo | Descrizione | Condizioni |
|---|---|---|
| to_currency | La valuta in cui desideri che il beneficiario riceva il pagamento | SGD |
| account_number | Il numero del conto corrente del beneficiario | Numero obbligatorio di 9-11 cifre, può includere il codice della filiale (branch_code) |
| bank_name | Il nome della banca che riceve i fondi | Obbligatorio, può contenere fino a 34 caratteri |
| bank_code | Codice identificativo bancario utilizzato per i pagamenti standard | Numero obbligatorio di 4 cifre |
| branch_code | Codice identificativo bancario utilizzato per i pagamenti standard | Numero obbligatorio di 3 cifre |
Pagamenti standard in Slovacchia
| Campo | Descrizione | Condizioni |
|---|---|---|
| to_currency | La valuta in cui desideri che il beneficiario riceva il pagamento | EUR |
| iban | Il numero del conto corrente internazionale (utilizzato principalmente in Europa) | Codice obbligatorio di 24 caratteri alfanumerici |
| bic_swift | Identificativo bancario utilizzato in tutto il mondo | Codice obbligatorio di 8 o 11 caratteri |
Pagamenti standard in Slovenia
| Campo | Descrizione | Condizioni |
|---|---|---|
| to_currency | La valuta in cui desideri che il beneficiario riceva il pagamento | EUR |
| iban | Il numero del conto corrente internazionale (utilizzato principalmente in Europa) | Codice obbligatorio di 19 caratteri alfanumerici |
| bic_swift | Identificativo bancario utilizzato in tutto il mondo | Codice obbligatorio di 8 o 11 caratteri |
Pagamenti standard in Spagna
| Campo | Descrizione | Condizioni |
|---|---|---|
| to_currency | La valuta in cui desideri che il beneficiario riceva il pagamento | EUR |
| iban | Il numero del conto corrente internazionale (utilizzato principalmente in Europa) | Codice obbligatorio di 24 caratteri alfanumerici |
| bic_swift | Identificativo bancario utilizzato in tutto il mondo | Codice obbligatorio di 8 o 11 caratteri |
Pagamenti standard in Svezia
| Campo | Descrizione | Condizioni |
|---|---|---|
| to_currency | La valuta in cui desideri che il beneficiario riceva il pagamento | SEK |
| account_number | Numero del conto corrente del beneficiario | 1-15 cifre |
| bank_code | Codice della banca beneficiaria | 4-5 cifre |
Pagamenti standard nel Regno Unito (incluse Jersey, Guernsey e Isola di Man)
| Campo | Descrizione | Condizioni |
|---|---|---|
| to_currency | La valuta in cui desideri che il beneficiario riceva il pagamento | GBP |
| account_number | Il numero del conto corrente del beneficiario | Numero obbligatorio |
| sort_code | Codice identificativo bancario utilizzato per i pagamenti standard | Numero di 6 cifre obbligatorio per i pagamenti locali verso il Regno Unito |
Pagamenti standard negli Stati Uniti
Deve indicare l’indirizzo della sede legale dell’azienda o la residenza principale della persona fisica che riceve il pagamento. Stringa obbligatoria. Deve essere un indirizzo negli Stati Uniti
| Campo | Descrizione | Condizioni |
|---|---|---|
| to_currency | La valuta in cui desideri che il beneficiario riceva il pagamento | USD |
| account_number | Il numero del conto corrente del beneficiario | Numero obbligatorio, può contenere fino a 17 cifre |
| aba | L’identificativo della banca utilizzato negli Stati Uniti, noto come ABA number | Numero obbligatorio di 9 cifre. Assicurati che venga fornito il codice di routing ACH piuttosto che quello del bonifico Fedwire o bancario |
| bank_account_type | Identifica il tipo di conto corrente | Può essere di tipo “Checking” (Conto corrente) o “Savings” (Conto di risparmio) |
| beneficiary_type | Identifica il tipo di beneficiario. La scelta determina alcuni dei campi riportati di seguito | Può essere “Company” (Azienda) o “Individual” (Persona fisica) |
| beneficiary_company_name | La ragione sociale dell’azienda | Stringa obbligatoria se scegli “Company” (Azienda) per il campo beneficiary_type |
| beneficiary_first_name | Il nome della persona fisica | Stringa obbligatoria se scegli “Individual” (Persona fisica) per il campo beneficiary_type |
| beneficiary_last_name | Il cognome della persona fisica | Stringa obbligatoria se scegli “Individual” (Persona fisica) per il campo beneficiary_type |
| beneficiary_address | Prima riga dell’indirizzo, compreso il numero o il nome dell’edificio | |
| beneficiary_city | La città in cui si trova l’indirizzo del beneficiario | Stringa obbligatoria. Deve indicare una città americana |
| beneficiary_postcode | Il codice postale dell’indirizzo del beneficiario | Stringa obbligatoria. Deve indicare un CAP americano (senza trattini e spazi) |
| beneficiary_state_or_province | Lo stato o la provincia in cui si trova l’indirizzo del beneficiario | Stringa obbligatoria se il campo beneficiary_country indica uno stato americano |
| beneficiary_country | Il codice del Paese in cui si trova l’indirizzo del beneficiario | Codice Paese ISO di 2 caratteri. Obbligatorio, deve indicare uno stato americano |
| payer_type | Identifica il tipo di pagatore. La scelta determina alcuni dei campi riportati di seguito | Può essere “Company” (Azienda) o “Individual” (Persona fisica) |
| payer_company_name | La ragione sociale dell’azienda | Stringa obbligatoria se scegli “Company” (Azienda) per il campo payer_type |
| payer_first_name | Il nome della persona fisica | Stringa obbligatoria se scegli “Individual” (Persona fisica) per il campo payer_type |
| payer_last_name | Il cognome della persona fisica | Stringa obbligatoria se scegli “Individual” (Persona fisica) per il campo payer_type |
| payer_address | Prima riga dell’indirizzo, compreso il numero o il nome dell’edificio. Deve indicare l’indirizzo della sede legale dell’azienda o la residenza principale della persona fisica che effettua il pagamento | Stringa obbligatoria |
| payer_city | La città in cui si trova l’indirizzo del pagatore | Stringa obbligatoria |
| payer_postcode | Il codice postale dell’indirizzo del pagatore | Stringa obbligatoria se il campo payer_country indica un indirizzo negli Stati Uniti (senza trattini e spazi) |
| payer_state_or_province | Lo stato o la provincia in cui si trova l’indirizzo del pagatore | Stringa obbligatoria se il campo payer_country indica uno stato americano |
| payer_country | Il codice del Paese in cui si trova l’indirizzo del pagatore | Codice Paese ISO di 2 caratteri. Obbligatorio se è impostato il campo payer_type |