Bizum (Hiszpania)

wskazówka

Akceptacja tego kanału płatności wymaga dodatkowej umowy z agentem rozliczeniowym wskazanym przez dpay.pl. Skontaktuj się z opiekunem handlowym dpay.pl, aby aktywować Bizum dla Twojego serwisu.

Bizum to popularna metoda płatności mobilnych w Hiszpanii, umożliwiająca szybkie przelewy między użytkownikami oraz płatności w sklepach internetowych. Klient autoryzuje transakcję bezpośrednio w aplikacji swojego banku.

Schemat działania

Klient

Twój serwer

dpay.pl

Press enter or space to select a node. You can then use the arrow keys to move the node around. Press delete to remove it and escape to cancel.

Press enter or space to select an edge. You can then press delete to remove it or escape to cancel.

POST/api/v1_0/payments/register→Pełny kontrakt rejestracji płatności: parametry, checksum i kody błędów.Pełny kontrakt w API Reference

Jak przebiega płatność

1. Klient wybiera Bizum jako metodę płatności i podaje numer telefonu powiązany z usługą Bizum.
2. Sklep rejestruje transakcję w dpay (waluta EUR).
3. Klient potwierdza płatność w aplikacji swojego banku.
4. Sklep otrzymuje powiadomienie IPN o wyniku transakcji.

Rejestracja transakcji

Transakcję Bizum rejestrujesz standardowym endpointem rejestracji z typem bizum_direct:

curl -X POST https://api-payments.dpay.pl/api/v1_0/payments/register \
  -H "Content-Type: application/json" \
  -d '{
    "service": "nazwa-serwisu",
    "value": "25.00",
    "currency_code": "EUR",
    "transactionType": "bizum_direct",
    "phone_number": "+34612345678",
    "url_success": "https://twojsklep.es/sukces",
    "url_fail": "https://twojsklep.es/blad",
    "url_ipn": "https://twojsklep.es/ipn",
    "checksum": "..."
  }'

Parametr	Typ	Opis
transactionType	string	bizum_direct
currency_code	string	EUR - jedyna waluta obsługiwana przez Bizum
phone_number	string	Numer telefonu klienta powiązany z Bizum, format +34XXXXXXXXX

Pozostałe parametry (w tym checksum liczony jako sha256(service|SecretHash|value|url_success|url_fail|url_ipn) z kwotą w formacie dwóch miejsc po przecinku) - identycznie jak w rejestracji transakcji.

Odpowiedź

Płatność przetwarzana jest po stronie dpay - odpowiedź nie zawiera adresu przekierowania, a klient potwierdza transakcję w aplikacji bankowej:

{
  "error": false,
  "msg": "Internal processing",
  "status": true,
  "transactionId": "42191111-A7AE-392E-8C09-7965C1DC6B0B"
}

O wyniku transakcji poinformuje Cię IPN.

Format numeru telefonu

Numer telefonu w standardowym formacie międzynarodowym:

+34XXXXXXXXX

Gdzie:

• +34 - kierunkowy Hiszpanii
• XXXXXXXXX - 9-cyfrowy numer telefonu

Przykład: +34612345678

Obsługa IPN

Powiadomienia IPN działają identycznie jak dla standardowych płatności. Szczegóły znajdziesz w Obsługa IPN.

informacja

Bizum wymaga, aby klient miał aktywną usługę Bizum w aplikacji swojego banku. Większość dużych banków hiszpańskich obsługuje Bizum.