Scenario 13: International Authorization

<< Back to the index

A debit cardholder purchases $300 worth of goods in a gift shop in Salvador, Brazil. The following are true:

  • The initial available balance is $1000.
  • The merchant validates the debit card with a signature.
  • The network is Mastercard Banknet.
  • The authorization and settlement amounts are in dollars, converted from the foreign currency.

Sequence of events

Events in the same step have the same timestamp.

  1. Mastercard sends an authorization request for –300.00.
  2. Galileo approves the request and places a 300.00 hold on the cardholder account. The available balance is now 700.00. Galileo sends a BAUT: auth webhook.
  3. Mastercard sends a batch file with –303.00 as the settlement amount, which is different from the authorization amount because of fluctuations in the currency conversion rate.
  4. Galileo backs out the 300.00 hold and posts –303.00 to the account. The available balance is now 697.00. Galileo sends a SETL: setl webhook.

Transactions

These tables show how the transactions are represented by various Galileo systems. For an explanation of the trans_code field, see Classifying transactions in the About Transactions guide.

Auth API

auth_typetransaction_typetrans_amountauth_idoriginal_idavailable_fundstimestamp
AuthAuth300.0044440100020210413:115944MST

Authorization/Settlement Events webhooks

msg_idtypeamountauth_idoriginal_auth_idopen_to_buytimestamp
BAUTauth300444407002021-04-13 11:59:44 MST
SETLsetl303444406972021-04-14 09:11:13 MST

Authorized Transactions RDF

TRANSACTION AMOUNTAUTHORIZATION CODETRANSACTION CODEREVERSAL IDTRANSACTION DATE/TIME
300.00-4444502021-04-13 11:59:44

Posted Transactions RDF

TRANSACTION AMOUNTAUTHORIZATION CODETRANSACTION CODE/TYPESOURCE IDTRANSACTION DATE/TIMEPOST DATE
303.00-4444SE544442021-04-13 11:59:442021-04-14 09:11:13

Get Authorization History response

This endpoint returns only transactions that have not settled or expired. These transactions are also returned by Get Account Overview. The local_amt field contains the sale amount in Brazilian Reals.

amtauth_idoriginal_auth_idtypelocal_amttimestamp
-30044440A0000001567712021-04-13 11:59:44

Get Transaction History response

This endpoint returns only settled transactions. These transactions are also returned by Get Account Overview.

amtsource_idoriginal_auth_idtrans_codeauth_tspost_ts
-30344440SE52021-04-13 11:59:442021-04-14 09:11:13

Get All Transaction History response

This endpoint returns the same transactions as the All Transactions screen of the CST.

amtauth_idprior_idtrans_codesource_idcalculated_balancecredit_indauth_tspost_ts
-30044440AUA4444700Y2021-04-13 11:59:442021-04-13 11:59:44
300None0BO544441000NoneNone2021-04-14 09:11:13
-30344440SE54444697Y2021-04-13 11:59:442021-04-14 09:11:13