Skip to main content

Braintree Local Payment Methods

This page provides an overview of the payments methods provided by the Braintree Local Payment Methods adapter in the IXOPAY platform. It also includes a full list of all configuration options available to you when integrating Braintree Local Payment Methods within your payments landscape, as well as an overview of the parameters required when submitting a transaction via IXOPAY's API.

Payment Methods

Payment MethodTransaction FlowsTransaction Types
Blikpayment.jsDebit, Refund

Integration guide

Braintree requires you to display the PayPal Button on your Checkout page. This is handled by the payment.js integration.

​1. Embed the payment.min.js in your page

<script data-main="payment-js" src=""></script>

It is important to set the data-main="payment-js" attribute on the script tag.

​2. Provide a DIV element on your page for the Local Payment Method button

<div id='localPaymentButtonDiv'></div>

​3. Initialize the payment.js with the following parameters:

  • ID of the DIV element
  • Javascript function to create a debit transaction and provide paymentId as transactionToken
  • Javascript function to handle payment completion
  • Javascript function to handle error events
  • Javascript function to handle cancellation events
  • Local Payment Method options (see example below)

var payment = new PaymentJs('1.3');

errorHandler = function (error) {
// handle error events here

cancellationHandler = function (data) {
// handle cancellation event here - called if user cancelled payment process

completeHandler = function (data) {
// handle completed transaction

paymentIdHandler = function (paymentId) {
// create a debit transaction including the paymentId in the request under the transactionToken parameter

let blikButtonDiv = document.getElementById('blikButtonDiv')

var localPaymentMethodOptions = {
paymentType: 'blik',
amount: '9.99',
currency: 'PLN',
firstName: 'Max',
lastName: 'Mustermann',
email: '[email protected]',
fallbackUrl: '[email protected]',
fallbackButtonText: 'Please retry'


​4. The transaction is created with a pending_postback status during the payment process by calling paymentIdHandler(). After the end customer has completed the payment, we rely on incoming webhooks from Braintree. Therefore, it can take up to 2 minutes before we update the transaction status.