Development environment
Development environment
WEBPAY Sandbox is a standalone web application that serves as a prototype of the production system. It is designed for testing and familiarizing users with the capabilities of the actual WEBPAY system. Functionally, it is identical to the production version, with the exception that it does not perform real bank card processing, meaning there will be no real transactions. Development and testing of payment modules must always be conducted in the test environment.
Test environment parameters
| Parameter | Description |
|---|---|
| Test environment URL: | https://sandbox.webpay.by |
| Username (login): | sent via email |
| Password: | sent via email |
Unique store ID (wsb_storeid): | sent via email |
To perform test transactions, you can use the following card parameters (only in the test environment):
- type: VISA
- number: 434179xxxxxx0051 (this field is not editable by default)
- CVV/CVC2: any three digits
- expiration date: any valid date. To simulate a payment error, enter December of the current year plus one (e.g., if the current year is 2019, enter 12/20).
Transitioning from test to production environment
Please note that when transitioning from the test to the production payment environment, the following requirements must be met.
Changing the payment page URL
To process real order payments, you must create a form with specific fields and use the POST method to redirect the customer to the payment page at https://payment.webpay.by.
Payment page URLs:
- Test payment page — https://securesandbox.webpay.by
- Production payment page — https://payment.webpay.by
Please Note
In the production environment, requests to https://payment.webpay.by must originate from the domain name specified in your internet acquiring agreement. According to payment system rules, subdomains are considered separate resources. For example, if your agreement specifies https://test.by, redirects to our payment page must originate from https://test.by. If the redirect originates from https://bill.test.by, the transaction will be blocked. The Referer URL is regularly verified in compliance with payment system and acquiring bank requirements. If you intend to use a domain other than the one specified in your agreement, please contact your personal WEBPAY manager.
The web application interface URL also changes:
- Test user acccount — https://sandbox.webpay.by
- Production user account — https://billing.webpay.by
Changing the store identifier
The store identifier in the WEBPAY system is passed in the wsb_storeid field. This parameter is created during registration and sent via email by your personal WEBPAY manager. You must replace it with the store identifier (wsb_storeid) from the production environment.
Changing the test payment flag
In the test environment, the wsb_test field with a value of 1 was used to indicate that payments should be processed using the payment system emulator rather than the production system. For production payments, set this field to 0.