SIsilverflow
BEP Authentication

Create BEP Authentication Intent

Generate a unique BEP payment initiation and return a QR code and an app intent to be used by the Bancontact app.

Requires the bep:Create permission.

post/bep

Request

Request body

webhookstring required

A valid URL

completionUrlstring

A valid URL

descriptionstring

An optional description to provide additional information to the cardholder in the payment approval screen of the Bancontact app.

Example request

{
  "merchantAcceptorResolver": {
    "merchantAcceptorKey": "mac-1eOdAHhgstYTUhlphPFf"
  },
  "webhook": "https://example.com",
  "amount": {
    "currency": "EUR"
  },
  "completionUrl": "https://example.com",
  "description": "Payment description"
}

Response

A BEP Intent

bepKeystring required

Uniquely identifies a BEP authentication request flow.

qrCodestring uri required

A URI which has to be encoded as a QR code to be scanned by the cardholder with the Bancontact app. The scanning of the QR code initiates the authentication process with the issuer. This is used when the cardholder shopping on a device which is not the same as the device which has their Bancontact app.

bancontactIntentstring uri required

An app deep link which can be called in order to automatically open the Bancontact app on the cardholder's device. This is used when the cardholder is using the same device for shopping and payment.

expiresstring iso-8601-date-time required

The date and time this BEP authentication intent expires.

createdstring iso-8601-date-time required

The date and time this BEP authentication intent was created.

versioninteger required

The version of this object

Example response

{
  "bepKey": "bep-1e1dAHhgstYTUhlphPzZ",
  "qrCode": "BEP://1BEP.SILVERFLOW.CO/EXAMPLE$GRCEG45D3UDE6T55NGA6X2PP",
  "bancontactIntent": "BEPGenApp://DoTx?TransId=1BEP.SILVERFLOW.CO/EXAMPLE$GRCEG45D3UDE6T55NGA6X2PP",
  "version": 1
}

Changes

No recorded changes to this operation across all 1 revision of this API.