Card Testing

Information on how to test card transactions
Cards
Card Testing
 last updated: 
November 30, 2023

You can create cards and simulate card transactions in Solid's TEST mode. This allows you to test your cards before you go LIVE without making actual money transactions. Follow these steps:

1. Create a Card (cardType: virtual)
2. Test a Card Auth transaction by passing the test amount

ENDPOINT

  1. POST /v1/card/:id/test

REQUEST

  1. {
  2. "amount": "14.90"
  3. }

200 OK success status response code indicates that the test transaction was posted.

Notes:
- currently you can use the simulation to test virtual cards only
- use it only in TEST mode
- pass the full amount (with dollar.cents) as a string. Ex: "10.00" or "4.90"
- interval limits and MCC restrictions are not supported in test mode

Other things you can test:
- pass an amount that is greater than the available balance to see a "decline" response
- pass different types of transactions in the "txnType" field, such as "authUpdate" or "reversal" or "refund"
- pass custom merchant data in the merchant sub-object

REQUEST WITH AUTHUPDATE, REVERSAL, OR REFUND (PASS parentTxnId)

  1. {
  2.   "amount": "20.00",
  3.   "parentTxnId": "txn-2c373294-4738-4b0d-9263-5de47deaead9",
  4.   "txnType": "authUpdate"
  5. }

REQUEST WITH MERCHANT DATA

  1. {
  2.   "amount": "10.00",
  3.   "merchant": {
  4.     "merchantName": "Wells Fargo ATM",
  5.     "merchantCity": "San Mateo",
  6.     "merchantState": "CA",
  7.     "merchantCountry": "US",
  8.     "postalCode": "94403",
  9.     "merchantCategory": "Automated Cash Dispenser",
  10.     "merchantCategoryCode": "6011"
  11.   }
  12. }

REQUEST FOR REFUND WITHOUT PARENT TRANSACTION ID

  1. {
  2.  "amount": "20.00",
  3.  "txnType": "refund"
  4. }