Skip to main content

White Label payment

This is API V1, which is no longer maintained

For up-to-date documentation, see the latest version.

Make a White Label payment​

The White Label means that the buyer is not redirected to the payment gateway. For example, for BLIK payment the buyer enters the authorization code directly on the store's website. Currently, integration with the White Label is available for BLIK and pay-by-link payments. To use White Label model, you need to:

  • get the list of payment methods, it is important to get the payment methods before each payment creation (you should not cache the payment methods)
  • create payment
    • BLIK
      • create it with authorizationCode
      • use the payment method where the value authorizationType field is equal to 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"
}

The information obligation results from the GDPR regulation about the protection of personal data. For non-White Label payments, the information is displayed on the Paynow payment page. In the case of White Label payments, you must additionally:

  • download and display the content of GDPR clauses from Notices endpoint (you can cache it, don't hardcode it)
{
  "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"
}
  • contact the Paynow team by sending a link to the store and a screenshot of the GDPR clauses embedded in the store, to the following address: support@paynow.pl.

After positive verification, the White Label will be configured in the paynow. Otherwise, this method will be unavailable and the merchant will have to use integration with redirect URL instead. Providing authorizationCode field in the payment request body for BLIK payment will cause a BAD_REQUEST error in that case.