Sandbox Transaction Testing Triggers
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 reasonExceeds 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.
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
]
}
Parameter | Type | Description | Notes | ||
---|---|---|---|---|---|
| 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. | ||
| object | Detail data object containing specific error code information. | |||
| integer | The identifier for the request sent. | |||
| number | The total amount used in the transaction. | |||
| object | Page data object containing page number and availability of more records on other pages. | |||
| number | The current page of records returned. | |||
| number | The last page containing records to be returned. | |||
| boolean | Whether there are more records that can be fetched. | It is designed to help with smart pagination (continuous scrolling feature) Valid values: | ||
| array | Error array containing a list of brief information about the error. | |||
| number | Returns the error code within the Payrix system. | |||
| number | Returns the gravity of the error. | Valid Values: 1 - 6 | ||
| string | A quick description or message about the error. | |||
| string | Indicating the error code and severity, explained in the |
More Information
You can read more about different API based testing triggers by visiting our API Reference documentation.