Przejdź do głównej zawartości

Płatność White Label

To jest API V1, które nie jest już utrzymywane

Aby zapoznać się z aktualną dokumentacją, zobacz najnowszą wersję.

Utwórz płatność White Label​

White Label oznacza, że kupujący nie jest przekierowywany do bramki płatności. Przykładowo dla płatności BLIK kupujący wpisuje kod autoryzacyjny bezpośrednio na stronie sklepu. Obecnie integracja z White Label dostępna jest dla płatności BLIK i pay-by-link. Aby skorzystać z modelu White Label należy:

  • pobrać listę metod płatności, ważne jest, aby pobrać metody płatności przed każdym utworzeniem płatności (nie należy zapisywać listy metod płatności w cache)
  • utworzyć płatność
    • BLIK
      • wykorzystaj wpis authorizationCode
      • użyj metody płatności, w której wartość pola authorizationType jest równa CODE
[
    {
        "type": "BLIK",
        "paymentMethods": [
            {
                "id": 2007,
                "name": "BLIK",
                "description": "Płacę z BLIKIEM",
                "image": "https://static.devel.integrator.emfale.com/payment-method-icons/2007.png",
                "status": "ENABLED",
                "authorizationType": "CODE"
            }
        ]
    }
]
{
  "amount": "409272",
  "externalId": "c7b55386-ba45-4537-96a5-bb77c6910418",
  "paymentMethodId": 2007,
  "currency": "PLN",
  "description": "Testowa transakcja",
  "continueUrl": "https://melements.pl",
  "buyer": {
    "email": "jan.kowalski@melements.pl",
    "firstName": "Jan",
    "lastName": "Kowalski",
    "locale": "pl-PL",
    "phone": {
      "prefix": "+48",
      "number": "120932212"
    }
  },
  "authorizationCode": "123456"
}

Obowiązek informacyjny wynika z rozporządzenia RODO o ochronie danych osobowych. W przypadku płatności innych niż White Label informacje są wyświetlane na stronie płatności Paynow. W przypadku płatności White Label musisz dodatkowo:

  • pobierz i wyświetl klauzulę RODO pobraną przez endpoint pobrania klauzul (możesz to zapisać w cache, ale nie zapisuj na sztywno w kodzie)
{
  "title": "mElements S.A. with its registered office in Warsaw, 00-850 at ul. Prosta 18 is the controller of your personal data.",
  "content": "The personal data provided by the Buyer will be used by mElements S.A. to execute the payment transaction.<br /> The agreement for the provision of the „Paynow\" Payment Integrator service constitutes the legal basis for the processing of personal data by mElements S.A.<br /> Personal data may be made available to the following entities: <ul class=\"data-processing-list\" style=\"list-style-type:lower-alpha\"> <li>institutions authorised to process data under the supervision conducted over mElements S.A. among other by the Polish Financial Supervision Authority (KNF), the Office of Competition and Consumer Protection (UOKiK);</li> <li>entities entrusted by us with data processing when providing services for our benefit.</li></ul> Personal data will be stored for a period not longer than 5 years after the termination of the agreement by one of the parties (in the event of a court dispute). After the expiry of the above periods, mElements will anonymise personal data.<br /> The Buyer has the right to access and rectify, transfer, delete, limit or object to the processing of his/her personal data. The Buyer also has the right to lodge a complaint with the supervisory body for the protection of personal data in the manner indicated on the website <a class=\"data-processing-link\" href=\"https://www.uodo.gov.pl\" target=\"_blank\">uodo.gov.pl</a> . Provision of data is voluntary, but necessary for the execution of payment, and failure to provide data may result in the rejection of the payment.<br /> More information on the rules governing the processing of your personal data by mElements can be found in the <a class=\"data-processing-link\" href=\"https://static.paynow.pl/docs/v1/privacy_policy_melements_en.pdf\" target=\"_blank\">Privacy Policy</a><br /> The function of the Personal Data Protection Officer is performed by an employee of mElements S.A., who can be contacted at: <a class=\"data-processing-link\" href=\"mailto:iod@melements.pl\" target=\"_blank\">iod@melements.pl</a>",
  "locale": "en-GB"
}
  • skontaktuj się z zespołem Paynow, wysyłając link do sklepu i zrzut ekranu klauzul RODO osadzonych w sklepie na następujący adres: support@paynow.pl.

Po pozytywnej weryfikacji White Label zostanie skonfigurowany w paynow. W przeciwnym razie ta metoda będzie niedostępna i Merchant będzie musiał użyć integracji z wykorzystaniem przekierowania URL. Podanie pola authorizationCode w treści żądania płatności dla płatności BLIK spowoduje w takim przypadku błąd BAD_REQUEST.