Configuration

After registering and verifying your account, you need to create a payment service in order to start accepting payments.

What is a payment service?

A payment point is a logical entity in the dpay.pl panel that represents your store or service. Each service has:

• Service name - a unique name used in API calls (the service or name field)
• Hash Key - a private key for generating checksums (SHA-256)
• Enabled payment channels - payment methods available to customers

Step 1: Creating a payment point

1. Log in to panel.dpay.pl.
2. Go to Payment Points > Services in the side menu.
3. Click Add new service.
4. Fill in the form:

Field	Description	Requirements
Service name	A friendly name for your service	5-30 characters
Service URL	Your website address	Full URL
Terms of service URL	Link to your store/service terms of service	Full URL
Complaints URL	Link to the complaints page	Full URL

5. Select payment channels (toggles):
   • PaySafeCard
   • BLIK BNPL
   • PayPo
   • Twisto
   • PayPal
   • Payment cards
   • Installments
6. Click Save.

info

A newly created service has an inactive status and awaits verification by the dpay team. Once approved, the status will change to active and you will be able to accept payments.

Step 2: Obtaining the Hash Key

The Hash Key is a private key required for generating checksums. To obtain it:

1. Go to Payment Points > Services.
2. Click on the desired service.
3. Scroll to the bottom.
4. You will find:
   • Service name: e.g. abc123
   • Hash Key (SHA-256): automatically generated

You can regenerate the Hash Key at any time - keep in mind that after regeneration, the previous key will stop working.

Protect the Hash Key

Never share the Hash Key publicly, do not include it in frontend code or in code repositories. Store it in server environment variables.

Example environment variables (.env)

DPAY_SERVICE=abc123
DPAY_HASH=9a8b7c6d5e4f3a2b1c0d...

Step 3: Test mode

A test mode toggle is available in the payment point settings:

• Allows you to test the integration without charging real accounts
• Transactions in test mode do not generate actual charges
• Switch to production mode when your integration is ready

Step 4: IPN retry configuration

The IPN (Instant Payment Notification) retry mechanism:

• Performs up to 10 retry attempts for IPN delivery in case of no response
• You can monitor IPN delivery status in the transaction history in the panel

Callback URLs

Callback URLs (success, fail, IPN) are specified per transaction in each API request - they are not configured globally on the service. See the Transaction Registration section for details.

What's next?

Configuration is complete! Proceed to Transaction Registration to make your first transaction via the API.