Sandbox Testing Triggers

Payrix Sandbox environment simulation parameters to trigger specific scenarios.

Using the Sandbox version of the Portal allows you to test scenarios normally impossible 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 an actual customer transaction.

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

Note: Any amount entered outside of the trigger amounts specified below will result in a standard successful response expected from the server for normal testing purposes.

Sandbox Testing Triggers

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

Using Sandbox Testing Triggers

Use the steps below to set up a transaction with the desired trigger amount.

For Card Transaction Triggers

• Step 1: Go to the Create Payment page.

• Step 2: Create a charge for a specific trigger amount. (See the table above).

• Step 3: Run the transaction with a test card number 4242 4242 4242 4242 (with any combination of “CVV” and future “Expiration” values).

• 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 - "Exceeds Approval Amount Limit"

Example

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

• Transaction Amount: $500.01 (Sale or Auth)

• Response Type: Platform

• Code: Declined

• Message: Exceeds Approval Amount Limit

For Disbursement Triggers

• Step 1: Go to the Payouts page

• Step 2: Click the View Schedules button to access the Payout Schedules page.

• Step 3: Click the Schedule Payout button in the upper right corner.

• Step 4: Set the following parameters and click the Schedule Payout button in the modal:

  • How often would you like to withdraw: One-Time

  • Amount: A specific Disbursement trigger amount (see the table above).

  • Amount Type: Actual

• Step 5: Allow the Payout to process in real-time (each day at 6:30 PM EST).

• Step 6: Return to the Payout page, and click the Payout Details button next to the payout you attempted under the Payout History section.

• Step 7: The Alerts section will display the message for your specified trigger, and display the amount under the Not Paid Out table. See the results below.

Example - "Unauthorized debit to consumer account"

For this example, we’ll use $501.29. This payout amount automatically triggers a General code and provides a message with the reason being Unauthorized debit to consumer account.

• Transaction Amount: $501.29 (Sale or Auth)

• Response Type: Platform (Vantiv)

• Code: General

• Message: Unauthorized debit to consumer account

Sandbox Testing Trigger API Response Structure

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.

"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
    ]
}

More Information

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