ATM Withdrawal, Visa Simulation
A cardholder withdraws $60 from a domestic ATM. The ATM operator charges a $3 fee and the issuer charges $2.50.
When simulating ATM fees, you must first set up the fee in your product settings: ATD for domestic and ATI for international. In the authorization request, add the operator fee to amount
but do not include your own fee—the simulator will add it automatically. You must also include the PIN for the card.
This example is similar to ATM withdrawal in Card Transaction Examples, except that these network codes correspond to the Visa credit network. In Production, an ATM transaction is almost never routed over credit (signature) rails but instead goes over interbank (PIN) or dedicated ATM rails. See Scenario 11: ATM Withdrawal and Scenario 12: ATM Reversal for examples from Production.
Authorization
Call Create Simulated Card Authorization with these parameters.
Parameter | Value |
---|---|
accountNo | PAN or PRN |
amount | 63 |
association | visa |
merchantName | Northern ATM |
mcc | 6011 |
specialFunctions | add_pin |
pin | Optional. If you pass a value, it uses this value in the request and changes the card's PIN to this value. If you do not pass a value here but specialFunctions: add_pin is present, then the request will use the existing PIN. |
transType | 11 |
{
"status_code": 0,
"status": "Success",
"processing_time": 1.887,
"response_data": {
"auth_response_code": "00",
"auth_response_description": "Success",
"auth_id": 2222
},
"echo": {
"provider_transaction_id": "",
"provider_timestamp": null,
"transaction_id": "dac933fb-4ef2-4996-9cb1-78e46b5964c5"
},
"system_timestamp": "2022-10-21 08:02:34",
"rtoken": "2157bc33-9f08-49c4-9e65-47dc195b0c60"
}
Capture the auth_id
for later use.
View the authorization
Call Get Authorization History to view the authorization. The amount
field contains the original $63 plus the issuer's $2.50 domestic ATM fee, whereas local_amt
does not include issuer fees.
{
"status_code": 0,
"status": "Success",
"processing_time": 0.427,
"response_data": {
"authorizations": [
{
"auth_id": "2222",
"details": "NORTHERN ATM LT LAKE CITY UTUS",
"details_formatted": "Northern ATM, LT LAKE CITY, UT",
"amount": "-65.5",
"timestamp": "2022-10-21 08:02:33",
"type": "W",
"mcc": "6011",
"merchant_id": "XqLDWeYStQw65dQ",
"acq_id": "826081",
"terminal_id": "11294228",
"can_be_expired": "1",
"original_auth_id": "0",
"network_code": "V",
"local_amt": "000000006300",
"local_curr_code": "840",
"settle_amt": null,
"settle_curr_code": null,
"billing_amt": null,
"billing_curr_code": null
}
]
},
"echo": {
"provider_transaction_id": "",
"provider_timestamp": null,
"transaction_id": "a841449a-04ec-41a4-a035-b55dc7eedcaf"
},
"system_timestamp": "2022-10-21 08:04:08",
"rtoken": "443c00e4-3053-48c4-b871-70df19991709"
}
Settlement
Call Create Simulated Card Settlement with these parameters:
Parameter | Value |
---|---|
authId | auth_id from the authorization response |
accountNo | PRN or PAN |
association | visa |
amount | blank |
{
"status_code": 0,
"status": "Success",
"processing_time": 5.546,
"response_data": {
"settle_response_code": "00",
"settle_response_description": "Success",
"settle_dtl": 1004
},
"echo": {
"provider_transaction_id": "",
"provider_timestamp": null,
"transaction_id": "032f41dd-677e-41dd-8a2e-0674045ee1e9"
},
"system_timestamp": "2022-10-21 08:07:06",
"rtoken": "b1c26b71-1d81-4731-8891-2351be6a2651"
}
Transactions created
Call Get All Transaction History to see the ledger entries in reverse chronological order. When the settlement is posted, the issuer fee is posted separately as an FE
(fee) transaction.
"transactions": [
{
"is_savings": false,
"deny_code": null,
"disputable": true,
"details": "Northern ATM, LT LAKE CITY, UTUS",
"act_type": "VS",
"act_type_description": "Visa Settlement",
"post_ts": "2022-10-21 08:07:04",
"amt": -63,
"source_id": "2222",
"type": "W",
"type_description": "",
"trans_code": "VSW",
"arn": "08260812294771103711038",
"merchant_id": "XqLDWeYStQw65dQ",
"external_trans_id": "",
"calculated_balance": 934.50,
"ach_trans_id": null,
"auth_ts": "2022-10-21 08:02:33",
"prior_id": "0",
"card_id": "5530",
"formatted_merchant_desc": "NORTHERN ATM, LT LAKE CITY, UTUS",
"network_code": "V",
"auth_id": "2222",
"local_amt": null,
"local_curr_code": null,
"settle_amt": null,
"settle_curr_code": null,
"billing_amt": null,
"billing_curr_code": null,
"pmt_ref_no": "999102163165",
"mcc_code": "6011",
"credit_ind": "N"
},
{
"is_savings": false,
"deny_code": null,
"disputable": false,
"details": "ATM Domestic Fee",
"act_type": "FE",
"act_type_description": "Fee",
"post_ts": "2022-10-21 08:07:04",
"amt": -2.5,
"source_id": "8888",
"type": "0013",
"type_description": "ATM Domestic Fee",
"trans_code": "FE0013",
"arn": "",
"merchant_id": null,
"external_trans_id": "",
"calculated_balance": 997.50,
"ach_trans_id": null,
"auth_ts": "2022-10-21 08:07:04",
"prior_id": "0",
"card_id": "5530",
"formatted_merchant_desc": null,
"network_code": "?",
"auth_id": "2222",
"local_amt": null,
"local_curr_code": null,
"settle_amt": null,
"settle_curr_code": null,
"billing_amt": null,
"billing_curr_code": null,
"pmt_ref_no": "999102163165",
"mcc_code": null,
"credit_ind": null
},
{
"is_savings": false,
"deny_code": null,
"disputable": false,
"details": "Northern ATM, LT LAKE CITY, UTUS",
"act_type": "BV",
"act_type_description": "Visa Authorization Backout",
"post_ts": "2022-10-21 08:07:04",
"amt": 65.5,
"source_id": "2222",
"type": "W",
"type_description": "",
"trans_code": "BVW",
"arn": "08260812294771103711038",
"merchant_id": "XqLDWeYStQw65dQ",
"external_trans_id": "",
"calculated_balance": 1000,
"ach_trans_id": null,
"auth_ts": "2022-10-21 08:02:33",
"prior_id": "0",
"card_id": "5530",
"formatted_merchant_desc": "NORTHERN ATM, LT LAKE CITY, UTUS",
"network_code": "V",
"auth_id": "2222",
"local_amt": null,
"local_curr_code": null,
"settle_amt": null,
"settle_curr_code": null,
"billing_amt": null,
"billing_curr_code": null,
"pmt_ref_no": "999102163165",
"mcc_code": "6011",
"credit_ind": "N"
},
{
"is_savings": false,
"deny_code": null,
"disputable": false,
"details": "Northern ATM, LT LAKE CITY, UTUS",
"act_type": "VI",
"act_type_description": "Visa Authorization",
"post_ts": "2022-10-21 08:02:33",
"amt": -65.5,
"source_id": "2222",
"type": "W",
"type_description": "",
"trans_code": "VIW",
"arn": "",
"merchant_id": "XqLDWeYStQw65dQ",
"external_trans_id": "",
"calculated_balance": 934.50,
"ach_trans_id": null,
"auth_ts": "2022-10-21 08:02:33",
"prior_id": "0",
"card_id": "5530",
"formatted_merchant_desc": "NORTHERN ATM, LT LAKE CITY, UTUS",
"network_code": "V",
"auth_id": "2222",
"local_amt": 63,
"local_curr_code": "840",
"settle_amt": 0,
"settle_curr_code": null,
"billing_amt": null,
"billing_curr_code": null,
"pmt_ref_no": "999102163165",
"mcc_code": "6011",
"credit_ind": "N"
}
Updated 6 months ago