Mobile Inline Gateway

Payment flow

2. Merchant app calls the merchant backend

This is necessary since only the backends can be trusted to communicate securely.

3. The merchant's backend calls the Barion API

The endpoint is the ususal payment/start. The merchant does not have to add any new information to the request.

6. Merchant's app intializes the Barion SDK

The merchant's app should request access to the camera. In the Barion SDK customers can scan their cards instead of typing them by hand. Add this key to your app's Info.plist:

NSCameraUsageDescription

The simplest and fastest integration of the Barion SDK looks like this:

import BarionSDK
...
let fastPayment = FastPayment(paymentClientSecret: paymentClientSecret)
fastPayment.present(from: self){ result in
  switch result {
    case .success(let paymentResult):
      // TODO handle successful payment result and validate it on your backend
      print("successful payment")
    case .failure(let paymentError):
      // TODO handle the error
      print(error.errorCode)
  }
}

The structure of the options parameter

{
  "merchantOwnedPaymentData": {
    "methods": [
      {
        "method": "card",
        "token": "sdafsfrRTYS556y7fdFG",
        "title": "My private card",
        "data": {
          "cardNr": "4578"
        }
      },
      {
        "method": "balance",
        "token": "sdafsfrRTYS556y7fdFG",
        "title": "My company card",
        "data": {
        }
      },
      {
        "token": "sdafsfrRTYS556y7fdFG",
      }
    ]
  },  
  "renderOptions": {
    "paymentMethodOrder": [
      "apple-pay",
      "card",
      "google-pay",
      "barion-wallet"
    ],  
    "gwOptions":{
      "arrowColor": "green",
    }
    "paymentMethodOptions": [
      {
        "method": "barion-wallet",
        "options": {
          "title": "Fizess Barionnal!",
          "background": "white"
        }
      },
      {
        "method": "apple-pay",
        "options": {
          "border": "black"
        }
      }
    ]
  }
}