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. At the bottom of the screen, Related Transactions displays the authorisations and payments that have been processed for the card. For more details see below.

    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


Transactions list

The Transactions list contains the following fields.

FieldDescription
Status indicatorA green dot represents an approved transaction, and a red dot represents a declined transaction
Date/Time UTCThe date and time that the transaction was processed in UTC time
SPIDThe system's unique identifier of a scheduled payment for an instalment, subscription, or metered order.
TypeSee Transaction types
Transaction unique IDThe Gateway ID for the transaction. Click to display the transaction details.
Reference IDThe Gateway ID of a previous related transaction. For example, if you refund a DB (debit) transaction, then the Reference ID of the refund is the Gateway ID of the DB transaction
AmountThe amount of the transaction. The amount will be debited from or credited to the merchant account, depending on the transaction type.
CurrencyThe currency of the transaction.
RefundIf it is possible to refund a DB or CP transaction, BillPro displays the circular arrow Refund button next to it. Click this button to make a refund. When the transaction has been fully refunded, BillPro will hide the Refund button.

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 whether 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, 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



Transaction details

The fields in the transaction details popup are as follows.

SectionFieldDescription
RequestOrder IDThe system's unique identifier for an order
Gateway IDThe Gateway ID for the transaction.
SPIDThe system's unique identifier of a scheduled payment for an instalment, subscription, or metered order.
Transaction TypeSee Transaction types
AmountThe amount of the transaction. Depending on the transaction type, the amount will be debited from or credited to the merchant account.
CurrencyThe currency of the transaction.
ProcessedThe date and time that the transaction was processed in UTC time
ResultAcquirer ResponseThe acquirer's response to the transaction. If it is blank, then the transaction may not have reached an acquirer
Scheme Response CodeThe transaction response code from the card schemes. See Declined Transactions above.
Merchant Advice CodeThe transaction response code from MasterCard. See Declined Transactions above.
Extended DescriptionThe extended description of the transaction response
Result CodeThe response code for the transaction from the payment gateway. For full details, see Gateway documentation on result codes. If a transaction is declined, the most helpful response codes are from 3D secure and external bank or payment systems. See Result codes for rejected transactions
DescriptionDescription of the result of the attempt to authorise the transaction from the payment gateway.
Clearing InstituteThe transaction processor
Card DetailsCard TypeVisa or Mastercard
Card BINThe first six digits of the card number
Card Last 4The last four digits of the card number
ExpiryThe month and year when the card expires in MM/YYYY format
3DSecureECIResponse code for the authentication attempt from the ACS or DS
VersionThe version of 3DSecure that was used for the authentication attempt
Auth TypeThe type of authentication used by the ACS
Verification IdThe unique identifier that you can use to prove that the authentication was carried out
DS Transaction IdThe unique identifier of the transaction in the DS
ACS Transaction IdThe unique identifier of the transaction in the ACS
Challenge Mandated IndicatorDefines whether the 3DS challenge is required or not (Y or N)

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 retry transactions automatically. 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 the card details. See Update cards.


Recommended reading

Display billing events in the payments section.