Testing

Testing your implementation will ensure your integration will successfully run transactions for common payment flows and prepare your for certification before going live. Failure to run these basic test cases will result in your integration potentially not working correctly and creating issues down the road.

Basic Test Cases

• Authorization
• Authorization, capture
• Authorization, partial capture
• Sale
• Refund
• Credit
• Void

Test Cards (U.S)

📘

Guidelines for testing U.S credit cards

• Credit card expiration dates should be any month and year in the future
• To cause a declined message, pass an amount less than 1.00
• To trigger a fatal error message, pass an invalid card number
• To simulate an AVS match, pass 888 in the address1 field, 77777 for zip
• To simulate a CVV match, pass 999 in the cvv field

Test Cards (Canada)

📘

Guidelines for testing Canadian credit cards

• Credit card expiration dates should be any month and year in the future
• Transactions in the test environment must not exceed $11.00
• To cause a declined message, pass a transaction amount of $0.05
• To trigger a fatal error message, pass an invalid card number

Test ACH

❗️

Triggering errors in test mode for ACH

• To cause a declined message, pass an amount less than 1.00.
• To trigger a fatal error message, pass an invalid card number.

Test Cloud EMV

There are two methods of testing Cloud EMV transactions. The sections below will walk you through testing with a physical terminals and testing with the Virtual Payment Terminal (VPT).

Physical Cloud EMV terminal

You can initiate a Cloud EMV transaction with ECRYPT's POS modal. Follow the steps below to run your first test transaction using Cloud EMV. Your device must be registered to your ECRYPT account to initiate the sale.

1. Navigate to the quick action button on the top left of the ECRYPT dashboard.
2. Select +POS
3. Select "Sale" for transaction type and complete the rest of the form fields. Click "Send to Terminal"
4. Your Cloud EMV device will now display a request for the transaction and sale amount. Complete the transaction by following the steps on the device.
5. Once the transaction is complete, navigate to "open transactions" in the ECRYPT dashboard, you will now see your transaction at the top of the table.

Virtual Payment Terminal (VPT)

VPT is a fully functioning virtual payment terminal designed to expedite integration times, and remove the requirement for "beta" payment terminals. VPT registration and transaction processing simulates physical payment terminal interactions for auditing, reporting, and testing. VPT is currently limited to VISA EMV.

VPT does not support handling “prompts” at this time, though sending the variables in your request will not cause errors.

Visit the terminal reference page to access the API endpoint for creating terminals

Test Data
Registration requests can be submitted using the following information:

• Registration Code: T00001 (Successful)
• Registration Code: T00002 (Failed)
• Amount 1.00 (Amounts under 1.00 generate failure)

Triggering Errors in Test Mode

• To cause a declined response, pass an amount less than 1.00.
• To trigger a fatal error message in processing, pass an invalid Payment Terminal ID.