Środowisko testowe

DPay Web EID udostępnia pełne środowisko sandbox umożliwiające testowanie integracji bez wpływu na produkcję ani rozliczenia.

Sandbox vs Produkcja

Cecha	Sandbox	Produkcja
Base URL	https://WSKAZANY_PRZEZ_SUPPORT.snd.dpay.pl/api/v1	https://WSKAZANY_PRZEZ_SUPPORT.dpay.pl/api/v1
Klucze API	deid_test_xxx	deid_live_xxx
Rozliczenia	Brak - sesje testowe nie są naliczane	Pełny biling
Demo provider	Dostępny	Dostępny (do testów)
Realne dane	Nie	Tak

Przełączanie między środowiskami

Aby przełączyć integrację między środowiskami, podmień:

1. Base URL - na właściwy host
2. Klucz API - na klucz odpowiadający środowisku

Przykład w PHP:

<?php
$baseUrl = getenv('APP_ENV') === 'production'
    ? 'https://WSKAZANY_PRZEZ_SUPPORT.dpay.pl/api/v1'
    : 'https://WSKAZANY_PRZEZ_SUPPORT.snd.dpay.pl/api/v1';

$apiKey = getenv('DPAY_EID_API_KEY'); // deid_live_xxx lub deid_test_xxx

Demo provider

W obu środowiskach (sandbox i produkcji) dostępny jest specjalny dostawca demo, który umożliwia testowanie pełnego flow weryfikacji bez integracji z prawdziwymi dostawcami (mObywatel, banki).

Sesja z demo providerem czeka na ręczne zatwierdzenie lub odrzucenie z poziomu panelu administracyjnego. Idealny do:

• Testów end-to-end pipeline'u integracji
• Demonstracji integracji klientom
• Testowania webhook handlerów

curl -X POST https://WSKAZANY_PRZEZ_SUPPORT.snd.dpay.pl/api/v1/verifications \
  -H "Authorization: Bearer deid_test_twoj_klucz" \
  -H "Content-Type: application/json" \
  -d '{"provider": "demo"}'

Szczegóły działania Demo providera w sekcji Metody weryfikacji - Demo.

Dobre praktyki

• Trzymaj osobne klucze dla local, staging, production - nigdy nie używaj klucza produkcyjnego w środowisku deweloperskim
• Loguj IDs sesji podczas testów aby móc je później odnaleźć w panelu
• Używaj external_id do mapowania sesji EID na własne identyfikatory zamówień/wniosków
• Konfiguruj webhooks na sandboxie używając tunelu typu ngrok do testowania lokalnego endpointu