Initiate your first Standalone Payment

To initiate a standalone payment you just need to create a Payment Request that will generate a consent_url. This URL will redirect your client to his bank interface to validate the payment.

The fields to complete are :

successful_callback_url: the client will be redirected on this URL if the payment initiation is a success
unsuccessful_callback_url (optional): the client will be redirected on this URL if the payment is a failure
transactions: the details of the payment you want the customer to initiate
- external_merchant_id (optional): this field is an open value that will be available on the payment request and will be sent to the bank
- currency
- label: the label of the payment which will be displayed on bank interfaces
- amount
- client_reference (optional): a reference to help you match the transaction to your system

📘
Reconciliation
Please note that all banks don't display the external_merchant_id on the beneficiary's interface. You may use the label to pass reconciliation information from end to end.

user
- name: name of your client which will initiate the payment
- ip_address: IP address of your client
- external_reference (optional): this field is an open value that will be available on the payment request
bank_id: id of the bank of your client
You can check which banks support the Standalone Payment thanks to the payment_enable field on the List banks.
client_reference (optional): a reference to help you match the payment request to your system

Please check the Manage beneficiaries chapter for this specific topic.

curl 'https://sync.bankin.com/v2/payment-requests' \
	-X POST \
  -H 'Bankin-Version: 2019-02-18' \
	-H 'Client-Id: MY_CLIENT_ID' \
	-H 'Client-Secret: MY_CLIENT_SECRET'
  -H 'Content-Type: application/json' \
  -d '{
  "successful_callback_url": "https://my-callback-url.com:8080/pay/success",
  "unsuccessful_callback_url": "https://my-callback-url.com:8080/pay/error",
  "transactions": [
    {
      "external_merchant_id": "12345678-AFERS",
      "currency": "EUR",
      "label": "Payment label",
      "amount": 99.5,
      "client_reference": "12345678-AZERTY"
    }
  ],
  "user": {
    "name": "Firstname Lastname",
    "ip_address": "0.0.0.0",
    "external_reference": "AEF142536-890"
  },
  "bank_id": 6,
  "client_reference": "12345678-AZERTY"
}'

curl 'https://sync.bankin.com/v2/payment-requests' \
	-X POST \
  -H 'Bankin-Version: 2019-02-18' \
	-H 'Client-Id: MY_CLIENT_ID' \
	-H 'Client-Secret: MY_CLIENT_SECRET'
  -H 'Content-Type: application/json' \
  -d '{
  "successful_callback_url": "https://my-callback-url.com:8080/pay/success",
  "unsuccessful_callback_url": "https://my-callback-url.com:8080/pay/error",
  "transactions": [
    {
      "external_merchant_id": "12345678-AFERS",
      "currency": "EUR",
      "label": "Payment label",
      "amount": 99.5,
      "client_reference": "12345678-AZERTY"
    }
  ],
  "user": {
    "name": "Firstname Lastname",
    "ip_address": "0.0.0.0",
    "external_reference": "AEF142536-890"
  },
  "beneficiary": {
    "name": "Firstname Lastname",
    "iban": "0.0.0.0"
  },
  "bank_id": 6
}'

The answer of the call will give :

id: id of the payment request
consent_url: bank URL to initiate the payment

{
  "id": "e959dccd632c49d7922a766e946ad9e9",
  "consent_url": "https://consent_url.com"
}

📘Reconciliation

📘
Reconciliation