Metody płatności

Wprowadzenie

Wiemy, że zależy Ci na tym, żeby klienci znaleźli na Twojej stronie to, czego szukają. To, czy dokonają zakupu, często zależy od tego, czy są w stanie skorzystać z preferowanej metody płatności. Straal daje Ci wachlarz możliwości, by pomóc Ci dostosować się do preferencji Twoich klientów.

W tej sekcji przeczytasz o:

  • tworzeniu i wykorzystywaniu obiektów reprezentujących karty płatnicze
  • obciążaniu kont bankowych transakcjami SEPA

Karty płatnicze

Karty płatnicze są najpopularniejszą na świecie metodą płatności. Przyjmuj płatności dokonywane za pomocą kart wszystkich wiodących organizacji, w ponad 150 walutach.

Straal pozwala na przyjmowanie następujących typów płatności przy użyciu karty:

  • pojedyncze płatności
  • płatności typu one-click
  • subskrypcje, naliczane automatycznie
  • płatności w terminalu POS w Twoim fizycznym punkcie sprzedaży

Obsługujemy karty następujących organizacji płatniczych:

Logo następujących organizacji kartowych: MasterCard, VISA, Maestro, JCB, UnionPay, Discover, AMEX, Cartes Bancaires, Dankort (DK) i Diners Club

Obsługiwane waluty

Straal obsługuje ponad 150 walut transakcyjnych oraz ponad 10 walut rozliczeniowych:

Rodzaj waluty Kod SWIFT
Waluty rozliczeniowe EUR, USD, GBP, PLN, CAD, CHF, HUF, SEK, NZD, NOK, DKK, HKD, AUD, JPY, HRK, TRY, CZK, RON, ZAR, SGD
Waluty transakcyjne AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYR, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CUP, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LTL, LVL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MUR, MVR, MWK, MXN, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, STD, SVC, SYP, SZL, THB, TJS, TMT, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VEF, VND, VUV, WST, XAF, XCD, XOF, XPF, YER, ZAR, ZMW, ZWD

Lista dostępnych walut uzależniona będzie od Twoich preferencji i zapotrzebowania. Warunki uruchomienia płatności możesz ustalić z naszym Działem Sprzedaży.

Przykład – dodaj kartę

Jeśli chcesz użyć karty w płatnościach typu one-click i subskrypcyjnych, musisz najpierw utworzyć obiekt card w systemie Straal. Ułatwia to również używanie karty w późniejszych transakcjach, ponieważ zamiast jej danych poufnych, możesz użyć jej ID.

Jeśli chcesz wykorzystać API Straal do dodania karty, wyślij żądanie POST do endpointu /customers/:customer_id/cards, w miejsce :customer_id wpisując ID klienta (odwiedź [APIref: Create a card (https://api-reference.straal.com/#resources-cards-create-a-card)). W przypadku nowego klienta najpierw będziesz musiał utworzyć obiekt klienta (szczegóły: APIref: Create a customer).

Przykładowa treść żądania

{
  "name": "Janina Kowalska",
  "number": "4111111111111111",
  "cvv": "123",
  "expiry_month": 11,
  "expiry_year": 2018,
  "origin_ipaddr": "91.17.133.219"
}

Przykładową odpowiedź serwera znajdziesz w APIref: Create a card. Więcej o kartach przeczytasz w APIref: Cards.

Przelew SEPA Direct Debit

Przelewy SEPA cieszą się popularnością w krajach europejskich, ponieważ dają możliwość łatwego przesyłania środków pomiędzy rachunkami prowadzonymi w walucie euro. Ta usługa jest dostępna w 34 krajach SEPA (Jednolitego Obszaru Płatniczego w Euro).

Zlecenie takiej płatności przypomina użycie karty płatniczej:

  • Przelewy są wykonywane poprzez system bankowy.
  • Klient, zamiast danych karty, wprowadza do formularza IBAN i autoryzuje transakcję.
Przykład – dodaj konto bankowe

Przelewy SEPA Direct Debit, wymagają aby klient podał swoje dane osobowe, IBAN (International Bank Account Number) i BIC swojego banku (Business Identifier Code, zwany także kodem SWIFT).

Jeżeli chcesz zainicjować transakcję SEPA, musisz najpierw utworzyć obiekt bank_account w systemie Straal. Dzięki temu, nie musisz za każdym razem przesyłać danych konta – wystarczy ID rachunku bankowego.

Jeśli chcesz wykorzystać API Straal do dodania rachunku bankowego, wyślij żądanie POST do endpointu /customers/:customer_id/bank_accounts, w miejsce :customer_id wpisując ID klienta (APIref: Create a bank account). W przypadku nowego klienta najpierw będziesz musiał utworzyć obiekt klienta (szczegóły: APIref: Create a customer).

Przykładowa treść żądania:

{
  "name": "Janina Kowalska",
  "iban": "DE89370400440532013000",
  "bic": "COBADEFFXXX",
  "origin_ipaddr": "91.17.133.219",
}

Przykładową odpowiedź serwera znajdziesz w APIref: Create a bank account.

Jak wykonać transakcję SEPA: APIref: Create a transaction for a bank account.

Przelewy Pay-By-Link to jedna z najpopulatniejszych metod płatności w Polsce. Przelewy te umożliwiają dokonywanie prostych i niemal natychmiastowych płatności bez potrzeby udostępniania karty lub numeru konta zewnętrznym instytucjom:

  • Klient dokonuje płatności poprzez zalogowanie się do internetowego systemu swojego banku
  • Pola przelewu są automatycznie uzupełnione
  • Przelew wymaga prostej autoryzacji przez Klienta np. poprzez przepisanie kodu bezpieczeństwa z wiadomości SMS

Straal oferuje przelewy Pay-By-Link Klientom posiadającym konto w większości polskich banków.

Przykład – stwórz obiekt płatności Pay-By-Link

W celu stworzenia płatności pay-by-link należy wykonać następujące kroki:

  1. Pobierz dostępne metody płatności Pay-By-Link, które możesz wyświetlić użytkownikowi do wyboru
  2. Stwórz obiekt customer, odpowiadający użytkownikowi koncowemu
  3. Wyślij żądanie o stworzenie płatności pay_by_link_payment
  4. Przekieruj użytkownika końcowego na URL otrzymany w odpowiedzi
  5. Przyjmij notyfikację informującą o statusie transakcji
1. Pobieranie dostępnych metod płatności Pay-By-Link

W celu pobrania metod płatności, należy wysłać żądanie GET na adres /payment_methods.

Istnieje możliwość filtrowania wyników przy użyciu parametrów GET.

Więcej szczegółów technicznych znajdziesz w: APIref: Get the list of payment methods.

2. Tworzenie obiektu customer

Płatności Pay-By-Link tworzone są dla istniejącego obiektu customer. Możesz pominąć ten ktok jeżeli masz już odpowiedni obiekt.

Więcej szczegółów technicznych znajdziesz w: APIref: Creating a customer.

3. Tworzenie obiektu płatności Pay-By-Link

Po tym jak użytkownik końcowy wybierze metodę płatności, powinniśmy przesłać jej identyfikator wraz z dodatkowymi polami opisującymi płatność Pay-By-Link na adres /customers/{customer_id}/pay_by_link_payments.

Więcej szczegółów technicznych znajdziesz w: APIref: Creating a pay-by-link-payment.

4. Przekierowanie użytkownika końcowego

Użytkownik końcowy powinien zostać przekierowany na adres redirect_url uzyskany z odpowiedzi pay_by_link_payment.

5. Odbieranie notyfikacji

Po zakończonej płatności, otrzymasz notyfikację pay_by_link_payment_succeeded w przypadku sukcesu lub pay_by_link_payment_failed w przypadku nieudanej płatności. Notyfikacja zawera obiekt transaction, który zawiera w sobie obiekt pay_by_link_payment. Wykorzystując id z obiektu pay_by_link_payment możesz połączyć transakcję z obiektem płatności utworzonym w punkcie 3.

Przeczytaj więcej o notyfikacjach: Notyfikacje systemowe.

Więcej szczegółów technicznych znajdziesz w: APIref: pay_by_link_payment_succeeded notification i APIref: pay_by_link_payment_failed notification.


Co dalej:


Jeśli coś jest dla Ciebie niejasne w tej sekcji, zajrzyj do Dokumentacji API Straal.

Możesz też sprawdzić Słowniczek, który pomoże Ci zapoznać się ze słownictwem z obszaru płatności.

Skontaktuj się z nami. Zespół Techniczny: [email protected], Dział Wsparcia Klienta: [email protected].