Skip to content

Bancontact

TS Integration option

Payment

Payment Flow

  1. The customer selects Bancontact as a payment method on the merchant's website.
  2. The merchant sends a payment request to GoldCharge.
  3. GoldCharge responds with a link to the payment page.
  4. The merchant redirects the customer to the payment page.
  5. The customer completes the payment.
  6. GoldCharge sends a webhook notification with the payment status to the merchant.

Info

This integration option supports only `PLN` and `EUR` currencies.
Request

Send a payment request with the following additional data:

Parameter Type Description
request object
return_url * required
 string URL to return the customer to when the transaction is completed.
method object A section of the payment method information.
type * required
 string bancontact
customer object A section of the customer details.
first_name * required
 string The customer's first name.
last_name * required
 string The customer's last name.
email * required
 string The customer's email address.
phone string The customer's phone number.
country * required
 string The customer's billing country in the ISO 3166-1 alpha-2 format.
Request example 
{
  "request": {
    "amount": 1098,
    "currency": "EUR",
    "description": "description",
    "test": false,
    "notification_url": "https://merchant.ltd/notification",
    "return_url": "https://return-url/",
    "customer": {
      "first_name": "John",
      "last_name": "Doe",
      "email": "example@example.com",
      "country": "DE"
    },
    "method": {
      "type": "bancontact"
    }
  }
}
Response

Redirect your customer to the URL received as the value of the form.action parameter.

Response example 
{
  "transaction": {
    "uid": "2df3135b-f016-418c-9da7-06beb04d9c28",
    "type": "payment",
    "status": "pending",
    "amount": 1098,
    "currency": "EUR",
    "description": "description",
    "created_at": "2024-06-12T13:10:05Z",
    "updated_at": "2024-06-12T13:10:26Z",
    "method_type": "bancontact",
    "receipt_url": "https://dashboard.gold-charge.com/customer/transactions/2df3135b-f016-418c-9da7-06beb04d9c28/404ea5109339c89591048b8a7653782bf551e017cc3293843e86ce744fd6b1e4",
    "payment": {
      "status": "pending",
      "gateway_id": 4098,
      "ref_id": "207723170543",
      "message": "Transaction was initialized.",
      "bank_code": "1000"
    },
    "bancontact": {
      "type": "bancontact"
    },
    "customer": {
      "first_name": "John",
      "last_name": "Doe",
      "email": "example@example.com",
      "country": "DE",
      "ip": "127.0.0.1"
    },
    "manually_corrected_at": null,
    "message": "Transaction was initialized.",
    "test": false,
    "billing_address": {
      "first_name": "John",
      "last_name": "Doe",
      "email": "example@example.com",
      "country": "DE"
    },
    "additional_data": {
      "payment_method": {
        "type": "alternative"
      }
    },
    "gateway": {
      "iframe": true
    },
    "form": {
      "action": "https://payment.ts.com/Order207723170543",
      "method": "GET",
      "fields": []
    }
  }
}