Display related transactions for an order

Check the related transactions for an order

To display the transactions for an order, do these steps.

  1. From an Orders list, click on the ID of the order or the CUSTOMER name.

  2. The Order Summary displays the order details. A the bottom of the screen, Related Transactions displays the authorisations and payments that have been processed for the card.

    Display the transactions related to an order

    Display the transactions related to an order


  3. To display processing details for a payment, click on the Transaction Unique ID. The Transaction Details pop-up will open. It includes the Result and the Card Details.

    Transaction details popup for an approved transaction

    Transaction details popup for an approved transaction


Approved transactions

If the transaction is approved, the gateway's Result Code will have a value of 000.000.000. In a test environment, it may have other values. The Scheme Response Code will have a value of 0. If it is a recurring payment, the Merchant Advice Code or Visa Category Code will also have a value of 0. If there are non-zero values, the transaction was declined.


Transaction approval flow

The transaction approval process goes through the entities in this order.

  1. Gateway
  2. Acquirer
  3. Card Scheme

In the transaction response, one or more codes are returned to the merchant via the gateway, depending on which stage in the approval process a transaction reaches.

Transaction response workflow

Transaction response workflow


Declined transactions

If a transaction is declined, the gateway's Result Code will be non-zero. For all gateway result codes, see Gateway documentation of result codes.

As an example, a gateway Result Code of 800.100.152 with the Description of transaction declined by authorization system means the transaction was declined by the issuer.

There will also be a non-zero Scheme Response Code or Acquirer Response Code, and an Extended Description, which can provide more details of why the transaction was declined.

For recurring payments, declined transactions may also have a Visa Category Code or Merchant Advice Code. These codes define if the transaction was hard-declined, due to a permanent issue with the card, or soft-declined due to a temporary issue with the card.

  • If the transaction is hard-declined, you cannot retry it.
  • If the transaction is soft-declined , you can retry it up to 15 times within 30 days of the soft decline.

If there is no Merchant Advice Code or Visa Category Code, or Scheme Response Code, it is possible that the transaction was soft-declined, or it may have failed at the payment gateway.


Visa table of Visa Category Codes (VCCs)

DescriptionVisa Category Code (VCC)In BillPro
Approved0Approved
Issuer will never approve1Hard-declined
Issuer cannot approve at this time2Soft-declined
Data quality issues / revalidate data3Soft-declined
Generic response codes4Soft-declined

MasterCard table of Merchant Advice Codes (MACs)

MAC CodeDescriptionIn BillPro
00ApprovedApproved
01Updated/additional information neededSoft-declined
02Try again laterSoft-declined
03Do not try againHard-declined
04Token requirements are not fulfilled for this token typeSoft-declined
21Payment cancellationHard-declined


Examples of transaction details

The following examples show declined transactions.

Expired card

For example, for an expired Visa card, the gateway sends a result code of 100.100.303.

A transaction that was hard declined due to an expired card

A transaction that was hard declined due to an expired card


Soft declined transaction

The following transaction was soft-declined. For MasterCard, a code value of 02 is soft-declined, and for Visa a code value of 2 is soft-declined. When a transaction is soft-declined, you can retry it (automatically or manually) up to 15 times in the following month. You can also configure BillPro to automatically retry transactions. See Auto-retry billing events.


Hard declined transaction

The following transaction was hard-declined. For MasterCard, a code value of 03 is hard-declined, and for Visa a code value of 1 is hard-declined. When a transaction is hard-declined, you cannot retry it. You must contact the customer and update card details. See Update cards.


Recommended reading

Display billing events in the payments section.