International Transaction, Visa Simulation

A cardholder with a U.S. account makes an international purchase for $23.50.

When simulating an international transaction, the simulator adds an international transaction fee to the authorization amount, if the ITC fee is configured. However, that fee is not included in the settlement by the simulator. Likewise, the simulator cannot settle for a different amount than the authorization, as is often the case with international transactions. For examples from Production, see Scenario 13: International Authorization and Scenario 14: International Reversal.

The simulator also cannot accept a value for currencyCode that is different from the currency of the account. For example, if the account is based in the United States, you can leave currencyCode blank, because it defaults to 840 (U.S. dollar). On the other hand, if you are simulating transactions for Mexican accounts, you must pass currencyCode: 484 (Mexican peso). In all cases, if you specify a code that is different from the account's currency code, you will get an error.

If you populate settleAmount, settleCurrencyCode, cardBillingAmt, or cardBillingCurrencyCode, those values will be passed through in the authorization request but they do not affect the amount for authorizations or settlements. The simulator cannot convert amounts from one currency to another.

Authorization

Call Create Simulated Card Authorization with these parameters.

Parameter	Value
`accountNo`	PRN or PAN
`amount`	`23.50`
`association`	`visa`
`merchantName`	`Mercado Las Americas`
`mcc`	`5411`
`transType`	`10`

{
    "status_code": 0,
    "status": "Success",
    "processing_time": 1.517,
    "response_data": {
        "auth_response_code": "00",
        "auth_response_description": "Success",
        "auth_id": 9999
    },
    "echo": {
        "provider_transaction_id": "",
        "provider_timestamp": null,
        "transaction_id": "20371789-d323-4a08-b601-bd8ee0d45e27"
    },
    "system_timestamp": "2022-10-20 16:41:09",
    "rtoken": "2f035169-4afc-425e-8fba-ec0b7aa6b6fe"
}

Capture the auth_id for later use.

View the authorization

Call Get Authorization History to see the authorization. The amount includes the international fee, whereas local_amt does not.

{
    "status_code": 0,
    "status": "Success",
    "processing_time": 0.058,
    "response_data": {
        "authorizations": [
            {
                "auth_id": "9999",
                "details": "Mercado Las Americas LT LAKE CITY UTUS",
                "details_formatted": "MERCADO LAS AMERICAS, LT LAKE CITY, UT",
                "amount": "-24.21",
                "timestamp": "2022-10-20 16:41:09",
                "type": "A",
                "mcc": "5411",
                "merchant_id": "4tJAtqkbhEE8h8u",
                "acq_id": "838547",
                "terminal_id": "62578819",
                "can_be_expired": "1",
                "original_auth_id": "0",
                "network_code": "V",
                "local_amt": "000000002350",
                "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": "7e9c2ace-7520-4b81-ba71-934ec80d603a"
    },
    "system_timestamp": "2022-10-20 16:41:52",
    "rtoken": "b382febf-1747-4fb1-8ba2-8288248d6780"
}

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.882,
    "response_data": {
        "settle_response_code": "00",
        "settle_response_description": "Success",
        "settle_dtl": 1007
    },
    "echo": {
        "provider_transaction_id": "",
        "provider_timestamp": null,
        "transaction_id": "b93b15f2-52ce-4d66-ae9e-ec3803c8883a"
    },
    "system_timestamp": "2022-10-21 09:24:06",
    "rtoken": "fc884d21-7774-4386-9ec4-b266f204dd06"
}

Transactions created

Call Get All Transaction History to see the ledger entries in reverse chronological order. The settlement does not include the international fee.

"transactions": [
            {
                "is_savings": false,
                "deny_code": null,
                "disputable": true,
                "details": "Mercado Las Americas, LT LAKE CITY, UTUS",
                "act_type": "VS",
                "act_type_description": "Visa Settlement",
                "post_ts": "2022-10-20 16:45:30",
                "amt": -23.5,
                "source_id": "9999",
                "type": "A",
                "type_description": "",
                "trans_code": "VSA",
                "arn": "18385472293893683936836",
                "merchant_id": "4tJAtqkbhEE8h8u",
                "external_trans_id": "",
                "calculated_balance": 976.50,
                "ach_trans_id": null,
                "auth_ts": "2022-10-20 16:41:09",
                "prior_id": "0",
                "card_id": "5530",
                "formatted_merchant_desc": "MERCADO LAS AMERICAS, LT LAKE CITY, UTUS",
                "network_code": "V",
                "auth_id": "9999",
                "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": "5411",
                "credit_ind": "Y"
            },
            {
                "is_savings": false,
                "deny_code": null,
                "disputable": false,
                "details": "Mercado Las Americas, LT LAKE CITY, UTUS",
                "act_type": "BV",
                "act_type_description": "Visa Authorization Backout",
                "post_ts": "2022-10-20 16:45:30",
                "amt": 24.21,
                "source_id": "9999",
                "type": "A",
                "type_description": "",
                "trans_code": "BVA",
                "arn": "18385472293893683936836",
                "merchant_id": "4tJAtqkbhEE8h8u",
                "external_trans_id": "",
                "calculated_balance": 1000,
                "ach_trans_id": null,
                "auth_ts": "2022-10-20 16:41:09",
                "prior_id": "0",
                "card_id": "5530",
                "formatted_merchant_desc": "MERCADO LAS AMERICAS, LT LAKE CITY, UTUS",
                "network_code": "V",
                "auth_id": "9999",
                "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": "5411",
                "credit_ind": "Y"
            },
            {
                "is_savings": false,
                "deny_code": null,
                "disputable": false,
                "details": "Mercado Las Americas, LT LAKE CITY, UTUS",
                "act_type": "VI",
                "act_type_description": "Visa Authorization",
                "post_ts": "2022-10-20 16:41:09",
                "amt": -24.21,
                "source_id": "9999",
                "type": "A",
                "type_description": "",
                "trans_code": "VIA",
                "arn": "",
                "merchant_id": "4tJAtqkbhEE8h8u",
                "external_trans_id": "",
                "calculated_balance": 976.50,
                "ach_trans_id": null,
                "auth_ts": "2022-10-20 16:41:09",
                "prior_id": "0",
                "card_id": "5530",
                "formatted_merchant_desc": "MERCADO LAS AMERICAS, LT LAKE CITY, UTUS",
                "network_code": "V",
                "auth_id": "9999",
                "local_amt": 23.5,
                "local_curr_code": "840",
                "settle_amt": 0,
                "settle_curr_code": null,
                "billing_amt": null,
                "billing_curr_code": null,
                "pmt_ref_no": "999102163165",
                "mcc_code": "5411",
                "credit_ind": "Y"
            }
]