Bank Transfer

The following is an example of a bank transfer request:

POST /v1/orders/ HTTP/1.1
Authorization: Basic aHVudGVyMjo=
Content-Type: application/json
    
{
  "currency": "EUR",
  "amount": 995,
  "merchant_order_id": "EXAMPLE001",
  "description": "Example Bank Transfer order",
  "return_url": "https://www.example.com/",
  "webhook_url": "https://www.example.com/webhook/",
  "transactions": [
    {
      "payment_method": "bank-transfer"
    }
  ]
}

The field reference will be returned in the response, which the customer will need to mention in the description of the bank transfer for identification on our side.

{
  "amount": 995,
  "client": {
    "user_agent": "Testing API"
  },
  "created": "2016-07-04T11:41:53.734183+00:00",
  "currency": "EUR",
  "id": "e4d22966-fbba-4753-ab89-b1ec9997171e",
  "last_transaction_added": "2016-07-04T11:41:54.028067+00:00",
  "merchant_id": "7131b462-1b7d-489f-aba9-de2f0eadc9dc",
  "modified": "2016-07-04T11:41:54.609881+00:00",
  "project_id": "1ef558ed-d77d-470d-b43b-c0f4a131bcef",
  "return_url": "https://www.example.com/",
  "status": "processing",
  "transactions": [
    {
      "amount": 995,
      "balance": "internal",
      "created": "2016-07-04T11:41:54.028067+00:00",
      "credit_debit": "credit",
      "currency": "EUR",
      "events": [
        {
          "event": "new",
          "id": "8c7f2802-9eee-44d1-b691-95bea6a2dc32",
          "noticed": "2016-07-04T11:41:54.154965+00:00",
          "occurred": "2016-07-04T11:41:54.028067+00:00",
          "source": "set_status"
        },
        {
          "event": "pending",
          "id": "80e845b6-c9e2-403d-a8d4-e193ab246767",
          "noticed": "2016-07-04T11:41:54.568740+00:00",
          "occurred": "2016-07-04T11:41:54.568740+00:00",
          "source": "set_status"
        }
      ],
      "expiration_period": "P30D",
      "id": "c511a0ec-a023-49a6-a5bf-00bdcaef2f21",
      "merchant_id": "7131b462-1b7d-489f-aba9-de2f0eadc9dc",
      "modified": "2016-07-04T11:41:54.837387+00:00",
      "order_id": "e4d22966-fbba-4753-ab89-b1ec9997171e",
      "payment_method": "bank-transfer",
      "payment_method_brand": "sepa",
      "payment_method_details": {
        "consumer_bic": "",
        "consumer_iban": "",
        "consumer_name": "",
        "reference": "9210201636861572",
        "creditor_account_holder_city": "Amsterdam",
        "creditor_account_holder_country": "Netherlands",
        "creditor_account_holder_name": "EMS",
        "creditor_bic": "NL08ABNA0000000XXX",
        "creditor_iban": "ABNXXXXX",
      },
      "project_id": "1ef558ed-d77d-470d-b43b-c0f4a131bcef",
      "status": "pending"
    }
  ]
}

Because the status of a bank transfer is always decoupled and delayed, the only way to be notified when the status has changed is to make use of the webhook.