INTEGRATION

Getting Started
Sandbox

Sandbox

Download icon

Sandbox

The sandbox environment is a controlled and simulated environment that allows clients to test and validate their integrations. Developers can use the sandbox to simulate various scenarios and test different functionalities of their applications. This includes testing data inputs, processing logic, error handling, and other critical integration aspects.

The primary purpose of the sandbox is to test integration between Silverflow and the user’s systems enabling clients to identify and resolve any issues or bugs without affecting genuine users and data.

The sandbox environment replicates the key components and configurations of the production environment. This includes APIs, service configurations, and other dependencies to closely mimic the real-world scenario in which the integration will operate.

Please be aware that Silverflow’s sandbox environment does not connect to the card networks’ simulators. Card network and issuer responses are generated by Silverflow internal components, intended to mock production responses. This isolation from the card networks provides a safe space to make changes and troubleshoot without risking disruption to live services. 

Note that the primary use of the Silverflow sandbox environment is to validate connectivity and request/response integration. Given that all card scheme components are mocked internally by Silverflow, the sandbox environment does not maintain an exhaustive list of potential network or issuer behavior.

The Sandbox environment is not fully reflective of the card scheme production environment, especially with regards to complex use cases. Completing your Silverflow integration in production always provides the full network responses for the full end-to-end processing flow. Please share any business logic implementation questions with your technical account manager so they can guide on how these can be validated on sandbox and implemented successfully on production.

Download icon

Use of PANs in Sandbox Environment 

Silverflow aims to allow maximum flexibility for its sandbox users. In order to accomplish this, in the sandbox environment Silverflow does not strictly validate PANs, rather it accepts a wide range of PANs, following the methodology per the table below. 

Note that PANs used in the sandbox environment should be minimum 12 digits in length, and a maximum of 19.

PAN prefix

Card Network

4

Visa

34, 37

American Express

51-55, 22-27

Mastercard

60, 64, 65

Discover

420035, 541353

Bancontact

Download icon

3DS Authentication PAN Ranges

PAN Prefix

Network

3DS Method URL

46354400000022

Visa

https://eu-west-1.sit-sbx.silverflow.com/v1/acs/method-initiate

341111

American Express

55203300000022, 2221-2720,

Mastercard

420035, 541353

Bancontact

 

Download icon

3DS Authentication Test Scenarios (for Mastercard & Visa)

Scenarios

Trigger

Remark

Frictionless flow

amount.value<3000

 

Challenge flow

amount.value>3000 or

challengeIndicator = challenge-preferred

 

Un-authenticated flow

card.holderName = fake

 

SF returns 500

card.holderName = error

 

Download icon

Authorization Test Scenarios

The Silverflow authorization in Sandbox is driven by amount-based testing. The sandbox logic standardizes testing by structuring amounts into three distinct parts:

Amount Structure:

  • Scenario: A major identifier representing broad test case categories (e.g., regular authorizations, AVS, CVC, POS, etc.).

  • Test Case: A two-digit identifier that differentiates variations within a scenario (e.g., specific AVS letters or CVC responses).

  • Response Code: A three-digit number aligning with network-specific response codes.

E.g., in order to trigger an authorization test case with response code 05 (do not honor), use the amount 100005. Please note that only test case scenarios as defined below are supported.

Download icon

POS Test Scenarios

For POS scenarios, test cases have been adjusted due to a technical limitation that prevents amounts exceeding 5000, as higher values would trigger a PIN requirement. To accommodate this, the “test case” portion has been removed, and only the “scenario” and “response code” are used.

See the table below for more amount based logic as described here above:

Amount

Description

Response Code

Regular authorizations (0100)

AMEX

Bancontact

Discover

Mastercard

Visa

Default

Approved

000

00

00

00

00

100005

Do not honor

 

 

05

05

05

100010

Partial amount / Partial Approval

 

 

10

10

10

100014

Invalid account/card number

 

 

 

14

14

100030

Format error

 

 

 

30

 

100051

Insufficient funds/over credit limit

 

 

 

51

51

100054

Expired card

 

 

52

 

 

100061

Insufficient funds/over credit limit/Decline

 

 

61

 

 

100065

Exceeds withdrawal count limit

 

 

65

 

65

100085

No reason to decline a request for address verification, CVV2 verification, or credit voucher or merchandise return

 

 

85

85

85

100101

Expired Card / Invalid Expiration Date

101

 

 

 

 

100116

Not Sufficient Funds

116

 

 

 

 

100165

Soft Decline (Customer Authentication Required)

 

 

1A

65

1A

Reversal (0400)

 

Default

Always approve reversal

 

 

00

00

00

Reversal advice (0420)

 

Default

Always approve reversal advice

400

 

00

00

00

POS (0100)

 

3055

Invalid PIN

117

 

55

55

55

3065

Mastercard: Exceeds withdrawal count limit (request PIN entry)

 

 

 

 

65

 

3165

Mastercard: Exceeds withdrawal count limit (Issuer PIN Request in a Single Tap Mode)

 

 

 

65

 

3075

Allowable number of PIN tries exceeded

106

 

75

75

75

3087

Purchase Amount Only, No Cash Back Allowed

 

 

 

87

 

3091

Issuer unavailable

 

 

91

91

91

Download icon

Specific AVS codes (0100)

Amount

AVS Result

Response Code

AMEX

Bancontact

Discover

Mastercard

Visa

414000

N

000

 

 

00

00

418000

R

000 

 

 

00

00

421000

U

000

 

 

 

00

423000

W

000 

 

 

00

 

424000

X

 

 

 

00

 

425000

Y

000 

 

00

00

00

426000

Z

 

 

 

00

00

Download icon

Specific CVC codes (0100)

Amount

CVC Result

Response Code

AMEX

Bancontact

Discover

Mastercard

Visa

513000

M

 

 

00

00

00

514000

N

 

 

00

 

 

514147

N

 

 

 

 

N7

514005

N

 

 

 

05

 

514100

N

100

 

 

 

 

516000

P

 

 

 

00

00

519000

S

 

 

 

 

00

521000

U

000

 

 

00

00

522000

Y

000

 

 

 

 

Download icon

Reconciliation

Reconciliation information is automatically generated as transactions are done on the platform. For each cleared transaction, there will also be a reconciliation entry. One chargeback is created each day for a random transaction of the previous day, and Silverflow also mocks two entries with fixed amounts for the card network fee types. This is visible in the reconciliationDetails report

To mimic bank reconciliation we aggregate all the captures, disputes and card network fees and mock a total bank transfer in the networkFundsTransfer report. The amount in this report matches with the aggregate of reconciliationDetails with the same networkFundsTransferKey