Integration Types
Altre funzionalità
Card Payments
Mobile Wallets
Alternative Payment Methods
Resources
Il Mastercard Gateway offre assistenza al provider di servizi per fornire informazioni su finanziamento e commissioni. La correttezza di queste informazioni è responsabilità del provider di servizi di pagamento.
Le informazioni su finanziamento e commissioni si riferiscono ai movimenti effettivi di fondi effettuati dal provider di servizi di pagamento da e verso il conto corrente bancario dell'esercente. Il finanziamento può essere positivo (finanziamento per un'acquisizione o un pagamento) oppure negativo (finanziamento per un rimborso). Le commissioni sono sempre negative. Vengono quindi addebitate sul conto corrente bancario dell'esercente.
Le informazioni su finanziamento e commissioni sono disponibili solo relativamente a ordini e transazioni per i quali il provider di servizi ha fornito le informazioni al Mastercard Gateway
Se le informazioni su finanziamento e commissioni sono forniti dal provider di servizi, è possibile recuperare tali informazioni dal Mastercard Gateway mediante:
RETRIEVE_ORDER
o RETRIEVE_TRANSACTION
È anche possibile effettuare l'iscrizione alle notifiche webhook per essere informati sugli aggiornamenti.
Le informazioni relative al finanziamento per una transazione, che includono l'importo e la valuta del finanziamento, sono registrate e associate a una transazione nei campi API indicati di seguito:
transaction.funding.amount
transaction.funding.currency
Finanziamento per un:
In base alle informazioni sul finanziamento relative ad una transazione, lo stato di finanziamento della transazione è aggiornato come indicato di seguito:
Campo API | Stato | Descrizione |
---|---|---|
transaction.funding.status |
NOT_SUPPORTED |
La transazione relativa all'ordine è stata liquidata da un istituto dal quale il Mastercard Gateway non riceve informazioni relative al finanziamento. |
NON_FUNDED |
La transazione non può determinare il trasferimento di denaro dal/al conto dell'esercente. E questo vale per le transazioni VERIFICATION o AUTHORIZATION . |
|
IN_PROGRESS |
La transazione potrebbe determinare il trasferimento di denaro al/dal conto dell'esercente, tuttavia tale trasferimento non è ancora avvenuto. Questo generalmente è uno stato transitorio. | |
FUNDING_ASSURED |
Per la transazione è garantito il trasferimento di fondi ma questo non è ancora avvenuto. | |
FUNDED |
La transazione ha trasferito denaro nel conto dell'esercente. | |
FUNDING_ON_HOLD |
La transazione potrebbe determinare il trasferimento di denaro al/dal conto dell'esercente, tuttavia il provider di servizi finanziari non è in grado di completare il trasferimento di fondi. Questo può essere uno stato transitorio. | |
FUNDING_FAILED |
La transazione potrebbe determinare il trasferimento di denaro al/dal conto dell'esercente, tuttavia il provider di servizi di pagamento non ha ancora ricevuto fondi dal pagante. Nel caso di un rimborso, il provider di servizi di pagamento non è stato in grado di trasferire i fondi al pagante. | |
FUNDING_ADJUSTED |
Un importo precedentemente finanziato per l'ordine è stato rettificato. La rettifica potrebbe essere un credito o un addebito sul conto dell'esercente. |
Il Mastercard Gateway fornirà almeno una delle date indicate di seguito per quando il finanziamento è avvenuto o avverrà.
Campo API | Descrizione |
---|---|
transaction.funding.date |
La data in cui i fondi arrivano nel conto corrente bancario dell'esercente. Il campo viene popolato solo se certo. |
transaction.funding.initiatedDate |
La data in cui l'acquirer ha avviato il trasferimento di fondi nel conto corrente bancario dell'esercente. Il campo viene popolato se non sono disponibili né la data di avvio né la data del finanziamento effettivo. |
transaction.funding.estimatedDate |
La data in cui l'acquirer prevede che i fondi arrivino nel conto corrente bancario dell'esercente. Il campo viene popolato solo le data è nota con certezza, ma la data dell'effettivo trasferimento fondi (transaction.funding.date ) non è certa. |
Quale delle date viene fornita dipende dalle informazioni fornite dall'acquirer. Tuttavia:
transaction.acquirer.timeZone
)Il Mastercard Gateway aggiornerà lo stato del finanziamento dell'ordine quando riceverà dall'acquirer l'informazione che il finanziamento per una determinata transazione è avvenuto.
Uno stato di finanziamento di una transazione FUNDING_ASSURED
o FUNDED
indica all'esercente che è sicuro inviare i beni al pagante.
Se il finanziamento per una transazione di pagamento o acquisizione non riesce, l'acquirer può richiamare i fondi, cioè addebitarli sul conto corrente bancario dell'esercente. In questo caso, viene creata una transazione con il tipo di transazione FUNDING
sull'ordine relativo alla transazione per la quale il finanziamento non è riuscito. Tale transazione avrà un importo pari a zero e la stessa valuta in cui è stato effettuato il finanziamento (valuta di trasferimento fondi). L'importo del finanziamento sarà negativo.
Se il finanziamento per una transazione di rimborso non è riuscita, l'acquirer può restituire i fondi all'esercente. Ad esempio, nel caso in cui non è stato possibile restituire i fondi al pagante in quanto il pagante ha chiuso il proprio conto. In questo caso, viene creata una transazione con il tipo di transazione FUNDING
sull'ordine relativo alla transazione per la quale il finanziamento non è riuscito. Tale transazione avrà un importo pari a zero e la stessa valuta in cui è stato effettuato il finanziamento (valuta di trasferimento fondi). L'importo del finanziamento sarà positivo.
L'importo del finanziamento riflette l'attuale stato del finanziamento per il denaro che può essere ragionevolmente previsto per questo ordine. Riflette sia gli accrediti sia gli addebiti sul conto corrente bancario dell'esercente. In sostanza, le vendite e i rimborsi.
Lo stato del finanziamento dell'ordine (order.fundingStatus
) è determinato dallo stato di finanziamento della transazione (transaction.funding.status
) delle transazioni assegnate all'ordine.
Quando il Mastercard Gateway considera lo stato del finanziamento, esamina solo le transazioni che possono trasferire fondi. Ad esempio, ignora le autorizzazioni e le acquisizioni rifiutate. Ciò accade perché lo stato del finanziamento dell'ordine riflette i movimenti di denaro per la transazione commerciali, non riflette i movimenti di denaro per le commissioni associate alla transazione.
Campo API | Stato | Descrizione |
---|---|---|
order.fundingStatus |
NOT_SUPPORTED |
Tutte le transazioni relative all'ordine sono state liquidate a un provider di servizi di pagamento dal quale il Mastercard Gateway non riceve informazioni relative al finanziamento. |
NON_FUNDED |
Non ci sono transazioni per l'ordine che potrebbero comportare il trasferimento di denaro dal/al conto dell'esercente. | |
IN_PROGRESS |
Vi sono transazioni sull'ordine che potrebbero determinare il trasferimento di denaro al/dal conto dell'esercente, ma per alcune si esse questo non è ancora avvenuto. Questo generalmente è uno stato transitorio. | |
FUNDING_ASSURED |
Per tutte le transazioni che potrebbero determinare il trasferimento di denaro al/dal conto dell'esercente, è garantito il trasferimento di fondi, ma questo non è ancora avvenuto. L'esatto importo dei fondi da trasferire, in questo stato, potrebbe non essere noto. | |
FUNDED |
Tutte le transazioni che potrebbero determinare il trasferimento di denaro al/dal conto dell'esercente sono in liquidazione e il trasferimento avverrà. | |
FUNDING_FAILED |
Vi sono transazioni sull'ordine che potrebbero determinare il trasferimento di denaro al/dal conto dell'esercente, tuttavia il provider di servizi di pagamento non è in grado di completare il trasferimento di fondi a causa di problemi con il conto. Questo può essere uno stato transitorio. | |
FUNDING_ON_HOLD |
Vi sono transazioni sull'ordine che potrebbero determinare il trasferimento di denaro al/dal conto dell'esercente, tuttavia il provider di servizi di pagamento non ha ancora ricevuto fondi dal pagante. In caso di un ordine con un rimborso, il provider di servizi di pagamento non è stato in grado di rimborsare i fondi al pagante. Potrebbe essere necessario contattare il pagante per sbloccare la situazione. |
L'importo del finanziamento dell'ordine (order.funding.amount
) riflette l'importo complessivo in denaro accreditato/addebitato sul conto corrente bancario dell'esercente per questo ordine (come indicato al Mastercard Gateway dall'acquirer). Tale importo include le vendite (accrediti sul conto) e i rimborsi (addebiti sul conto).
Fare riferimento allo Stato del finanziamento dell'ordine (order.funding.status
) per determinare la certezza di questo valore.
La valuta del finanziamento dell'ordine (order.funding.currency
) è impostata sullo stesso valore della valuta di finanziamento della transazione (transaction.funding.currency
) della prima transazione finanziata per un ordine.
Per le transazioni elaborate tramite un acquirer per il quale non vengono fornite informazioni sul finanziamento nel Mastercard Gateway, lo stato di finanziamento della transazione è impostato su NOT_SUPPORTED
.
Esistono tre tipi di commissioni dell'acquirer:
Le informazioni relative alle commissioni applicabili per una transazione sono fornite nei seguenti campi API:
transaction.funding.fee[n].feeType
transaction.funding.fee[n].acquirerFeeName
transaction.funding.fee[n].amount
transaction.funding.fee[n].rate
Gli importi delle commissioni sono addebitati sul conto dell'esercente dall'acquirer, ma sono importi positivi nell'API.
Le informazioni relative alle commissioni applicabili per un esercente o un evento sono fornite in caso di un ordine di finanziamento autonomo.
Per un ordine di finanziamento autonomo sono disponibili i seguenti dettagli dell'ordine:
Campo dell'ordine | Descrizione |
---|---|
order.id |
ID emesso dal Mastercard Gateway. |
order.amount |
0 |
order.currency |
Impostare sulla valuta di trasferimento fondi della commissione dell'esercente o relativa ad eventi registrata. |
order.status |
Impostare su FUNDING_ONLY . |
order.fundingStatus |
Impostare su NON_FUNDED . |
sourceOfFunds.type |
Impostare su NONE . |
order.description |
Contiene una stringa che spiega che l'ordine contiene solo informazioni sulle commissioni. |
Per un ordine di finanziamento autonomo sono inoltre disponibili i seguenti dettagli della transazione:
Campo della transazione | Descrizione |
---|---|
transaction.id |
ID emesso dal Mastercard Gateway. |
transaction.amount |
0 |
transaction.type |
Impostare su FUNDING . |
Gruppo di parametri transaction.funding.fee[n] . |
Informazioni sulle commissioni. |
Se le commissioni applicabili per un esercente o un evento sono fornite dall'acquirer per un determinato esercente con un ID acquirer associato a più di un esercente nel Mastercard Gateway, le informazioni vengono registrate solo una volta (rispetto a un singolo profilo dell'esercente).
transaction.acquirer.id
).L'importo delle commissioni sulla transazione (transaction.funding.feeAmount
) viene fornito nella valuta del trasferimento fondi (transaction.funding.feeCurrency
) e riflette l'importo complessivo delle commissioni addebitate sul conto corrente bancario dell'esercente per questa transazione (come indicato al Mastercard Gateway dall'acquirer).
Gli importi delle commissioni possono essere forniti con un massimo di 4 cifre decimali (indipendentemente dall'esponente della valuta). Pertanto, l'importo totale della commissione per la transazione potrebbe non coincidere con la somma di tutte le commissioni a causa degli arrotondamenti.