Payrix sandbox environment test scenario parameter and trigger values.

Using the Sandbox version of the Portal allows you to test scenarios that would normally not be possible in testing. We’ve created a set of specific amounts that trigger an automatic decline, error, or other message that would normally only occur from a actual customer transaction.

See the instructions below for a quick start to testing additional transaction triggers.

How to Test Transaction Triggers in the Sandbox:

Step 1: Go to Create Payments:

Step 2: Create a charge for a specific trigger amount.

  • Note: For this example, we’ll use $500.01. This transaction amount automatically triggers a Decline and provides a message with the reason Exceeds Approval Amount Limit .

Step 3: Run the transaction with a test card 4242 4242 4242 4242 (with any combination of CVV and Expiration Date).

Step 4: Locate the transaction in the Payments History page list. Then click on the transaction to be taken to Transaction Details.

Step 5: Click the Alerts tab from the Transaction Details menu in the lower-half of the page. See the result below.

Example

  • Declined : Exceeds Approval Amount Limit

    • Sale or Auth transaction for $500.01


Transaction Testing Triggers

To test additional transactions events using this trigger system, follow the steps above but replace $500.01 with one of the transaction amounts from the Testing Triggers expandable table below.

Expand for a full list of Testing Triggers

See a list of all Transaction Testing Trigger Amounts and their descriptions:

Standard Transaction Testing

Transaction Amount

Message

$500.01

Exceeds Approval Amount Limit

$500.13

Corporate Customer Advises Not Authorized (for eCheck transactions)

$500.04

Insufficient Funds

$95.87

Declined

$848.00

Processing Network Unavailable

$848.01

Issuer Unavailable

$848.02

Re-submit Transaction

$848.03

Call Issuer

$848.04

Merchant not certified/enabled for IIAS

$848.05

Issuer Generated Error

$848.06

Restricted Card

$848.07

Card Not Active

$848.08

Illegal Transaction

$848.09

Duplicate Transaction

$848.10

System Error

$848.11

System Error (cannot process)

$848.12

Lost/Stolen Card

$848.13

Expired Card

$848.14

Restricted Card

$848.15

No such issuer

$848.16

Transaction not allowed at terminal

$848.17

Cardholder transaction not permitted

$848.18

Cardholder requested that recurring or instalment payment be stopped

$848.19

Do Not Honor

$848.20

Decline - Request Positive ID

$848.21

Processing Network Error

$848.22

Soft Decline - Primary Funding Source Failed

$848.23

Soft Decline - Auto Recycling In Progress

$848.24

Internal System Error - Call Vantiv

$848.25

Generic Decline

Chargeback

Transaction Amount

Message

$5,000.00

Chargeback

Batch Echo

Transaction Amount

Message

$10.10

Partially Approved

$10.11

Offline Approval

$11.08

Try again later

$11.11

The total amount of the original Authorization has been used.

$22.07

Pickup card - Other than Lost/Stolen

$22.09

Invalid Amount

$22.11

Reversal Unsuccessful

$22.12

Missing Data

$33.01

Invalid Account Number

$33.03

Pick Up Card

$33.08

Restricted Card - Chargeback

$33.23

No such issuer

$33.48

Invalid Report Group

$33.60

There were no transactions found with the specified Transaction Id.

$33.61

The authorization for this transaction is no longer available. Either the authorization has already been consumed by another capture, the authorization has expired, or the cardholder revoked the authorization.

$33.62

This transaction cannot be voided; it has already been delivered.

$33.63

This transaction (both capture and refund) has been voided.

$33.69

The redeposit attempted against an invalid transaction type.

$33.70

Internal System Error - Call Vantiv

$33.71

Do not send additional redeposit transactions, since the original transaction was processed.

$55.01

The account was closed

$500.04

Insufficient Funds

$848.00

Processing Network Unavailable

$848.01

Issuer Unavailable

$848.02

Re-submit Transaction

$848.03

Call Issuer

$848.04

Merchant not certified/enabled for IIAS

$848.05

Issuer Generated Error

$848.06

Restricted Card

$848.07

Card Not Active

$848.08

Illegal Transaction

$848.09

The transaction is a duplicate of a previously submitted transaction.

$848.10

System Error

$848.11

System Error (cannot process)

$848.12

Lost/Stolen Card

$848.13

Expired Card

$848.14

Restricted Card

$848.16

Transaction not allowed at terminal

$848.17

Cardholder transaction not permitted

$848.18

Cardholder requested that recurring or installment payment be stopped

$848.19

Do Not Honor

$848.25

Generic Decline

Transactions

Whether sending these testing trigger transactions using our Portal or API, you’ll receive a response returned from our servers that looks like the JSON file below. This is simply the API version of the messages you’ll see in the Alerts tab of the Portal as mentioned above.

Standard Testing Trigger API Response

"response": {
  "data": [],
  "details": [
    "requestId": 1,
    "totals": [],
    "page": [
      "current": 0,
      "last": 0,
      "hasMore": false
    ]
  ],
  "errors": [
    "code": 201
    "severity": 4
    "msg": Exceeds Approval Amount Limit
    "errorCode": Decline
    ]
}
JSON

Parameter

Type

Description

Notes

data

array

Data array containing the intended data elements requested for the transaction.

This will be different per request parameters and payload.

This array will return empty when there is an error. When a transaction is successfully sent, the data array will contain additional info.

details

object

Detail data object containing specific error code information.

requestID

integer

The identifier for the request sent.

totals

number

The total amount used in the transaction.

page

object

Page data object containing page number and availability of more records on other pages.

current

number

The current page of records returned.

last

number

The last page containing records to be returned.

hasMore

boolean

Whether there are more records that can be fetched.

It is designed to help with smart pagination (continuous scrolling feature) Valid values: True & False

errors

array

Error array containing a list of brief information about the error.

code

number

Returns the error code within the Payrix system.

severity

number

Returns the gravity of the error.

Valid Values: 1 - 6

msg

string

A quick description or message about the error.

errorCode

string

Indicating the error code and severity, explained in the msg field.

More Information

You can read more about different API based testing triggers by visiting our API Reference documentation.