Solidgate’s sandbox testing capabilities, which encompass successful transactions, failures, fraud detection, and error modeling, are valuable for identifying potential issues and ensuring system stability.

By testing various payment methods such as card payments, Google Pay, Apple Pay, and PayPal, you can ensure interoperability and security, and prepare your integration for real-world scenarios.


Payment outcomes

To test your Solidgate integration, use your sandbox channel with specific keys:

  • Webhook keys, which start with the prefix wh_pk_ / wh_sk_ , allow for receiving simulated webhook notifications.
  • API keys, starting with api_pk_ / api_sk_ , are used to make API requests within sandbox.

Test scenarios are available to simulate processing , success , and failed , which are crucial for assessing your system’s readiness and reliability across varied payment conditions.

CARD NUMBER 4067429974719265 TEST CARD
Expiry date Any future date within the next 50 years is valid. 12/34
CVV/CVC Use any 3-digit code or 4-digit for Amex. 123
Cardholder Use any placeholder values. Name Surname
Card number varies depending on the payment scenario like success or decline.

Success

Success CARD NUMBER 4067429974719265 SUCCESS
auth success
settle success
recurring success
void success
refund success
Testing includes scenarios such as auth + settle , with certain limitations on timing and transaction status. Recurring success CARD NUMBER 4532456618142692 RECURRING
recurring success
An example of the recurring token card_token , which you can receive via the check order status API / updated card order Webhook notification after payment.

Declined

Auth CARD NUMBER 4553815318053315 AUTH FAILED
auth failed
settle success
recurring success
void success
refund success
This scenario tests placing a temporary hold on funds, ensuring they are available for final transaction confirmation. Steps include creating an order processing, attempting authorization, and verifying if it fails auth_failed. Settle CARD NUMBER 5361074849060618 SETTLE FAILED
auth success
settle failed
void failed
refund success
This scenario involves a merchant attempting to finalize a transaction by capturing previously authorized funds, transferring the amount from the customer's to the merchant's account. Steps include successful authorization auth_ok, settlement attempt, and verifying if the transaction settles or fails. Void CARD NUMBER 5361074849060618 VOID FAILED
auth success
settle failed
void failed
refund success
The customer initiates an authorization to temporarily hold a specific amount on their card, ensuring funds are available but not immediately transferred. This allows for final confirmation before transaction completion. Testing involves creating an order in the processing status, attempting authorization, and checking if the order transitions to the auth_failed status, indicating a failed authorization attempt. Recurring CARD NUMBER 4123212486997559 RECURRING FAILED
auth success
settle success
recurring failed
void success
refund success
Testing recurring payments involves executing an auth to receive a token used for a recurring operation. For recurring auth payments, perform the initial payment through auth , receive a token upon successful authorization, and use this token for a recurring payment with another authorization step. The recurring transaction transitions to the fail status, indicating the recurring setup failure, while the order transitions to the declined status. Refund CARD NUMBER 4476284533825961 REFUND FAILED
auth success
settle success
recurring success
void success
refund failed
This scenario tests the refund process, intended to reverse a previously successful charge and return funds to the customer. The procedure involves confirming a successful payment settle_ok, initiating a refund, and validating the outcome. Successful refunds should transition the status to refunded, while failures maintain the original settle_ok status.

Errors

Use the test cards to simulate payments that the issuer rejects for various reasons. This can be useful for testing the error-handling logic of your integration.


General decline

These errors reflect declined transactions from bank refusals, order time-outs, compliance issues, or authentication failures.

  • 0.01 General decline
  • 0.02 Order expired
  • 0.03 Illegal operation
0.01 CARD NUMBER 4510108818406882 ERROR 0.01 error : {code: 0.01 , message: "General decline"} 0.02 CARD NUMBER 4532003312475364 ERROR 0.02 error : {code: 0.02 , message: "Order expired"} 0.03 CARD NUMBER 4929213352238223 ERROR 0.03 error : {code: 0.03 , message: "Illegal operation"}
Validation errors

These errors indicate that correcting the input data can typically resolve invalid transaction data.

  • 2.06 Invalid CVV2 code
  • 2.08 Invalid card number
  • 2.09 Invalid expiration date
  • 2.10 Invalid 3DS flow on merchant side
2.06 CARD NUMBER 5299389115628964 ERROR 2.06 error : {code: 2.06 , message: "Invalid CVV2 code"} 2.08 CARD NUMBER 4539146503757117 ERROR 2.08 error : {code: 2.08 , message: "Invalid card number"} 2.09 CARD NUMBER 4945960509912296 ERROR 2.09 error : {code: 2.09 , message: "Invalid expiration date"} 2.10 CARD NUMBER 4857027008185133 ERROR 2.10 error : {code: 2.10 , message: "Invalid 3DS flow on merchant side"}
Transaction declines

Transaction refusal may be caused by factors such as card limits, insufficient balance, or suspected fraud, which often requires contacting the bank or using alternative payment methods.

  • 3.01 Card is blocked
  • 3.02 Insufficient funds
  • 3.03 Payment amount limit excess
  • 3.04 Transaction is declined by issuer
  • 3.05 Call your bank
  • 3.06 Debit card not supported
  • 3.07 Card brand is not supported
  • 3.08 Do not honor
  • 3.10 Suspected fraud
3.01 CARD NUMBER 5462413335551193 ERROR 3.01 error : {code: 3.01 , message: "Card is blocked"} 3.02 CARD NUMBERS 5151948477715326 4890838637940261 recurring ERROR 3.02 error : {code: 3.02 , message: "Insufficient funds"} 3.03 CARD NUMBER 4485664001324176 ERROR 3.03 error : {code: 3.03 , message: "Payment amount limit excess"} 3.04 CARD NUMBERS 5361250317309261 2490161849593101 recurring ERROR 3.04 error : {code: 3.04 , message: "Transaction is declined by issuer"} 3.05 CARD NUMBER 4916242642369774 ERROR 3.05 error : {code: 3.05 , message: "Call your bank"} 3.06 CARD NUMBER 5261820900437819 ERROR 3.06 error : {code: 3.06 , message: "Debit card not supported"} 3.07 CARD NUMBERS 4347225319309917 5134431550984251 recurring ERROR 3.07 error : {code: 3.07 , message: "Card brand is not supported"} 3.08 CARD NUMBER 4907428874384745 ERROR 3.08 error : {code: 3.08 , message: "Do not honor"} 3.10 CARD NUMBERS 4283184051091165 4423511615594071 recurring ERROR 3.10 error : {code: 3.10 , message: "Suspected fraud"}
Fraud and anti-fraud

These errors indicate that a transaction was flagged for potential fraud, often involving blocklisted or stolen cards or triggered antifraud rules. Merchants should display a general decline message and either investigate further or advise the customer to try again.

  • 4.02 Stolen card
  • 4.05 PSP antifraud
  • 4.07 Trusted antifraud system
4.02 CARD NUMBER 4983102885450335 ERROR 4.02 error : {code: 4.02 , message: "Stolen card"} 4.05 CARD NUMBER 4075752033922822 ERROR 4.05 error : {code: 4.05 , message: "PSP antifraud"} 4.07 CARD NUMBER 6011491463366455 ERROR 4.07 error : {code: 4.07 , message: "Trusted antifraud system"}
Data or card verification

These errors relate to address mismatches, failed 3D verification, and issues with card tokens, requiring merchants to verify customer information, check for fraud, and consult support as needed.

  • 5.01 3D secure verification failed
  • 5.02 Invalid card token
  • 7.01 Card token not found
5.01 CARD NUMBER 5539974195624197 ERROR 5.01 error : {code: 5.01 , message: "3D secure verification failed"} 5.02 CARD NUMBER 4485589319980072 ERROR 5.02 error : {code: 5.02 , message: "Invalid card token"} 7.01 CARD NUMBER 5241981397484014 ERROR 7.01 error : {code: 7.01 , message: "Card token not found"}
Connection or processing issues

These errors relate to transaction issues and connection errors. Solutions include retrying, using a different card, or contacting the bank.

  • 5.03 Application error
  • 5.08 Invalid transaction
  • 6.02 Connection error
5.03 CARD NUMBER 5414915934193648 ERROR 5.03 error : {code: 5.03 , message: "Application error"} 5.08 CARD NUMBER 5199914302370491 ERROR 5.08 error : {code: 5.08 , message: "Invalid transaction"} 6.02 CARD NUMBER 4935964870334207 ERROR 6.02 error : {code: 6.02 , message: "Connection error"}
Card blocked or restricted

These errors refer to transactions blocked due to lost or restricted cards, requiring merchants to offer alternative payment options and check for potential fraud.

4.04 CARD NUMBER 4222192107639022 ERROR 4.04 error : {code: 4.04 , message: "Lost card"}
Merchant configuration or activation errors

These errors are related to merchant configuration and API communication issues. The resolution steps include contacting the Solidgate support or ensuring proper API method usage.

5.04 CARD NUMBER 5394262465415346 ERROR 5.04 error : {code: 5.04 , message: "Merchant is not configured correctly"}

3D Secure authentication

Testing 3DS flow where the cardholder must complete additional authentication steps. This scenario simulates the full 3D Secure authentication process with cardholder verification.

3DS CARD NUMBER 497592770594980 3DS
auth success
recurring success

Cards brand

Use a list of test cards to verify the payment system.

VISA CARD NUMBER 4532456618142692 VISA
auth success
settle success
recurring success
void success
refund success
Testing this particular card brand is essential for ensuring smooth and secure transactions for customers, ultimately enhancing customer satisfaction and trust in the payment system. Mastercard CARD NUMBER 5329777445319300 MASTERCARD
auth success
settle success
recurring success
void success
refund success
Testing this particular card brand is crucial for ensuring compatibility and reliability in transactions, key to maintaining customer trust and minimizing transaction declines. Maestro CARD NUMBER 6763428189229070 MAESTRO
auth success
settle success
recurring success
void success
refund success
Ensuring Maestro card compatibility enhances global transaction reliability, essential for expanding market presence and strengthening consumer trust. JCB CARD NUMBER 3527602488193781 JCB
auth success
settle success
recurring success
void success
refund success
Testing JCB cards is essential for seamless global transactions, enhancing customer trust, and expanding market accessibility, ensuring broad compatibility and reliability. Discover CARD NUMBER 6011218207927015 DISCOVER
auth success
settle success
recurring success
void success
refund success
Assessing Discover card transactions ensures broad acceptance and seamless payment experiences, reinforcing confidence in payment infrastructure. UnionPay CARD NUMBER 6229261954246138 UNIONPAY
auth success
settle success
recurring success
void success
refund success
Testing UnionPay cards is vital for ensuring global financial inclusivity and transactional efficacy, fostering wider acceptance and customer convenience. Amex CARD NUMBER 371495481347626 AMEX
auth success
settle success
recurring success
void success
refund success
Testing American Express cards is essential for guaranteeing high-end transaction security and enhancing premium service offerings, vital for customer satisfaction and retention. Diners CARD NUMBER 36527094796869 DINERS
auth success
settle success
recurring success
void success
refund success
Ensuring seamless transaction processing for Diners Club cards is essential to delivering exceptional service experiences and maintaining a loyal, high-value customer base.

Estimated and incremental auth

Test estimated incremental authorization flows to ensure your integration handles authorization types correctly.

Success CARD NUMBER 4067429974719265 SUCCESS
auth estimated success
auth incremental success
Recurring success CARD NUMBER 4532456618142692 RECURRING
auth estimated success
auth incremental success
Declined CARD NUMBER 4553815318053315 AUTH FAILED
auth estimated failed
auth incremental failed
CARD NUMBER 5140308911473822 INCREMENTAL FAILED
auth estimated success
auth incremental failed
3DS CARD NUMBER 497592770594980 3DS
auth estimated success

Mastercard CARD NUMBER 5329777445319300 MASTERCARD
auth estimated success
auth incremental success
Amex CARD NUMBER 371495481347626 AMEX
auth estimated success
auth incremental success
Diners CARD NUMBER 36527094796869 DINERS
auth estimated success
auth incremental success

Apple Pay or Google Pay

Sandbox provides a secure environment for simulating the integration of Google Pay and Apple Pay, ensuring no risk to actual bank accounts or transactions.

Before beginning tests, please consult with your account manager regarding configuration needs. Keep in mind that Google Pay and Apple Pay digital wallets require the use of real cards and test cards are not work.

For the initial one-time payment, using any amount not detailed below result in a standard approval, ensuring all subsequent recurring payments on that token are automatically approved. However, to initiate a specific recurring or recurring auth payment outcomes, the initial transaction must have predefined amount values, which should be specified in cents, for example, amount 100 means 1:

Using an amount different from the specified values for the initial transaction ensures that subsequent recurring payments are always approved. This demonstrates the flexibility of the system in handling various transaction types.

Success AMOUNT 100 SUCCESS success without 3DS AMOUNT 666 SUCCESS success with 3DS AMOUNT 555 SUCCESS success with frictionless 3DS Error AMOUNT 1 ERROR 0.01 error : {code: 0.01 , message: "General decline"} AMOUNT 301 ERROR 3.01 error : {code: 3.01 , message: "Card is blocked"} AMOUNT 302 ERROR 3.02 error : {code: 3.02 , message: "Insufficient funds"} AMOUNT 3020 ERROR 3.02 error : {code: 3.02 , message: "Insufficient funds"} with frictionless 3DS AMOUNT 304 ERROR 3.04 error : {code: 3.04 , message: "Transaction is declined by issuer"} AMOUNT 308 ERROR 3.08 error : {code: 3.08 , message: "Do not honor"} AMOUNT 3080 ERROR 3.08 error : {code: 3.08 , message: "Do not honor"} with 3DS AMOUNT 310 ERROR 3.10 error : {code: 3.10 , message: "Suspected fraud"} AMOUNT 403 ERROR 4.03 error : {code: 4.03 , message: "Restricted card"} Processing AMOUNT 549 PROCESSING processing AMOUNT 649 PROCESSING processing with 3DS AMOUNT 749 PROCESSING processing with frictionless 3DS

PayPal

PayPal testing allows you to simulate failed transactions using a sandbox environment, which is useful for ensuring that your system correctly handles various scenarios, including negative flows.

Technical declines generated in the sandbox environment do not appear in PayPal's administrative dashboards.
  • Before you begin testing, ensure that your development environment is set up correctly.
  • To perform testing, request access to the PayPal sandbox account from your account manager.

To test failed payments, set the API request with currency to USD and a specific amount, which should be specified in cents like amount 302 means 3.02, to trigger errors.

Init payment AMOUNT 302 ERROR 3.02 error : {code: 3.02 , message: "Insufficient funds"} AMOUNT 305 ERROR 3.05 error : {code: 3.05 , message: "Call your bank"} AMOUNT 308 ERROR 3.08 error : {code: 3.08 , message: "Do not honor"} Recurring AMOUNT 301 ERROR 3.01 error : {code: 3.01 , message: "Card is blocked"} AMOUNT 302 ERROR 3.02 error : {code: 3.02 , message: "Insufficient funds"} AMOUNT 305 ERROR 3.05 error : {code: 3.05 , message: "Call your bank"} AMOUNT 308 ERROR 3.08 error : {code: 3.08 , message: "Do not honor"} AMOUNT 502 ERROR 5.02 error : {code: 5.02 , message: "Invalid card token"} AMOUNT 512 ERROR 5.12 error : {code: 5.12 , message: "Account is blocked"}