Scenario 3: Incremental Authorizations

<< Back to the index

A debit cardholder calls a ride-share service through its app, and the cost of the proposed destination is $25. After arriving at the first destination the cardholder requests a second destination for $15, and then after arriving at the second destination requests a third, for $10.

  • The initial available balance is $1000.
  • The cardholder pays using a mobile wallet.
  • The network is Visa.

Sequence of events

Events in the same step have the same timestamp.

  1. Visa sends an authorization request for –25.00.
  2. Galileo approves the request and places a 25.00 hold on the account. The available balance is now 975.00. Galileo sends the BAUT: auth webhook.
  3. Visa sends an incremental authorization request for –40.00.
  4. Galileo approves the request, backs out the previous 25.00 hold, and places a new 40.00 hold on the account. The available balance is now 960.00. Galileo sends the BAUT: auth webhook.
  5. Visa sends another incremental authorization request for –50.00.
  6. Galileo approves the request, backs out the previous 40.00 hold, and places a new 50.00 hold on the account. The available balance is now 950.00. Galileo sends the BAUT: auth webhook.
  7. Visa sends a clearing file with the –50.00 settlement.
  8. Galileo backs out the 50.00 hold and posts –50.00 to the account. The available balance is still 950.00. Galileo sends the 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_fundsincremental_authtimestamp
AuthAuth25.00333301000.00False20210617:142135MST
AuthAuth40.0066663333975.00True20210617:162917MST
AuthAuth50.0099996666960.00True20210617:170840MST

Authorization/Settlement Events webhooks

msg_idtypeamountauth_idoriginal_auth_idopen_to_buytimestamp
BAUTauth25333309752021-06-17 14:21:35 MST
BAUTauth40666633339602021-06-17 16:29:17 MST
BAUTauth50999966669502021-06-17 17:08:40 MST
SETLsetl50999966669502021-06-19 17:47:19 MST

Authorized Transactions RDF

TRANSACTION AMOUNTAUTHORIZATION CODETRANSACTION CODEREVERSAL IDTRANSACTION DATE/TIME
25.00-3333502021-06-17 14:21:35
40.00-6666533332021-06-17 16:29:17
50.00-9999566662021-06-17 17:08:40

Posted Transactions RDF

TRANSACTION AMOUNTAUTHORIZATION CODETRANSACTION CODE/TYPESOURCE IDTRANSACTION DATE/TIMEPOST DATE
50.00-9999VSA99992021-06-17 17:08:402021-06-19 17:47:19

Get Authorization History response

This endpoint returns only transactions that have not settled or expired. These transactions are also returned by Get Account Overview. This example shows all three authorizations; however, in Production you would get only the most recent transaction. The local_amt field contains the amount of the increment and amt contains the cumulative amount.

amtauth_idoriginal_auth_idtypelocal_amttimestamp
-2533330A00000000025002021-06-17 14:21:35
-4066663333A0000000015002021-06-17 16:29:17
-5099996666A0000000010002021-06-17 17:08:40

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
-5099996666VSA2021-06-17 16:45:022021-06-19 17:47:19

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
-2533330VIA3333975Y2021-06-17 14:21:352021-06-17 14:21:35
25NoneNonePVPV33331000NoneNone2021-06-17 16:29:17
-4066663333VIA6666960Y2021-06-17 14:21:352021-06-17 16:29:17
40NoneNonePVPV66661000NoneNone2021-06-17 16:45:02
-5099996666VIA9999950Y2021-06-17 16:45:022021-06-17 17:08:40
5099996666BVA99991000Y2021-06-17 16:45:022021-06-19 17:47:19
-5099996666VSA9999950Y2021-06-17 16:45:022021-06-19 17:47:19