Przejdź do głównej zawartości

Direct Billing

Na tej stronie poznasz przepływ płatności Direct Billing i sprawdzisz, czy Twój token działa z DirectBilling API. W Direct Billing kwota jest pobierana przez operatora sieci komórkowej płatnika (direct carrier billing). Używasz tego samego tokenu, tych samych hostów i tego samego formatu błędów co przy płatnościach online.

Jak to działa​

  1. Tworzysz transakcję na swoim punkcie płatności i dostajesz redirectUrl.
  2. Przekierowujesz klienta na redirectUrl.
  3. O zmianach statusu dowiadujesz się z webhooka DIRECTBILLING.TRANSACTION_STATUS_CHANGED, a aktualny stan możesz w każdej chwili pobrać z API.

Tylko status PAID oznacza, że płatność się udała. Utworzenie transakcji (201) ani powrót klienta na adres redirect.success nie oznacza zapłaty.

Wymagania​

  • Token API z panelu (Integracja → Dostęp do API), przekazywany w nagłówku Authorization: Bearer YOUR_API_TOKEN. Zob. Wprowadzenie.
  • Aktywny punkt płatności Direct Billing (pointId). Dla nieaktywnego punktu API odpowiada 400 z kodem POINT_NOT_ACTIVE.
  • Kwota w PLN od 1.00 do 200.00, nie wyższa niż maksymalna kwota skonfigurowana dla punktu.
  • Jeśli podajesz numer płatnika (msisdn): tylko numery polskie, w formacie +48 i 9 cyfr.

Do testów użyj hosta https://api.sandbox.paymentic.com, na produkcji https://api.paymentic.com.

Sprawdź połączenie​

curl "https://api.sandbox.paymentic.com/v1_2/directbilling/ping" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "data": {
    "message": "pong",
    "environment": "sandbox",
    "tokenId": "2a77157f-7a73-413d-90a1-cd1263533d61",
    "clientId": "72b631fe",
    "version": "1.2",
    "scopes": ["*"]
  }
}

Pole environment (sandbox albo production) potwierdza, z którym środowiskiem rozmawiasz.

Co dalej​