Blik

PCT Integration option

Payment

Payment Flow

1. The customer selects Blik as a payment method on the merchant's website.
2. The merchant sends a payment request to the GoldCharge.
3. GoldCharge responds with a link to the payment page with the fields to be filled in by the customer.
4. The merchant redirects the customer to the payment page.
5. The customer inserts the Blik code on the payment page and completes the payment.
6. GoldCharge sends a webhook notification with the payment status to the merchant.
7. The merchant displays the payment status to the customer.

Info

This integration option supports only `PLN` currency.

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	blik
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 * required	string	The customer's phone number. + must be specified.

Request example

{
    "request": {
        "amount": 50000,
        "currency": "PLN",
        "description": "description",
        "test": true,  
        "return_url": "https://return.com",     
        "customer": {
            "first_name": "John",
            "last_name": "Doe",      
            "phone": "+48699018515",
            "email": "example@example.com"
        },
        "method": {
            "type": "blik"       

        }
    }
}

Response

The blik response section will have the parameters copied from the request as well as the form object to build a form where you should redirect the customer to finalize the payment.

Response example

{
    "transaction": {
        "uid": "6aef6af5-ccc6-446c-9892-ce408287833c",
        "type": "payment",
        "status": "pending",
        "amount": 50000,
        "currency": "PLN",
        "description": "description",
        "created_at": "2023-11-28T12:03:33Z",
        "updated_at": "2023-11-28T12:03:33Z",
        "method_type": "blik",
        "receipt_url": "https://dashboard.gold-charge.com/customer/transactions/6aef6af5-ccc6-446c-9892-ce408287833c/8c3a2090ac4d68a9e2f9f8bb9d3ff10ef9b54708eb144c77bbb5a5b102684ab0",
        "payment": {
            "status": "pending",
            "gateway_id": 3462,
            "ref_id": "6aef6af5-ccc6-446c-9892-ce408287833c",
            "message": "Transaction was initialized"
        },
        "blik": {
            "type": "blik"
        },
        "customer": {
            "first_name": "John",
            "last_name": "Doe",
            "email": "example@example.com",
            "phone": "+48699018515 ",
            "ip": null
        },
        "manually_corrected_at": null,
        "message": "Transaction was initialized",
        "test": true,
        "billing_address": {
            "first_name": "John",
            "last_name": "Doe",
            "email": "example@example.com",
            "phone": "+48699018515",
        },
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },     
        "gateway": {
            "iframe": true
        },
        "form": {
            "action": "https://cashier.pct.eu/en/payment_systems/pay?id=ccce71c0-3477-410a-a370-661eb018bd78",
            "method": "GET",
            "fields": []
        }
    }
}

TS Integration option

Payment

Payment Flow

1. The customer selects Blik 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 inserts the Blik code on the payment page and 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	blik
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": "PLN",
    "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": "PL"
    },
    "method": {
      "type": "blik"
    }
  }
}

Response

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

Response example

{
  "transaction": {
    "uid": "8c28c939-3828-44a3-8769-ad6d0ac5865c",
    "type": "payment",
    "status": "pending",
    "amount": 1098,
    "currency": "PLN",
    "description": "description",
    "created_at": "2024-06-12T14:08:34Z",
    "updated_at": "2024-06-12T14:08:34Z",
    "method_type": "blik",
    "receipt_url": "https://dashboard.gold-charge.com/customer/transactions/8c28c939-3828-44a3-8769-ad6d0ac5865c/390aebca777a8bec00d1f16332cdaf597f308a7dda6316cd94b1f0161e075ad3",
    "payment": {
      "status": "pending",
      "gateway_id": 4098,
      "ref_id": "209598761127",
      "message": "Transaction was initialized.",
      "bank_code": "1000"
    },
    "blik": {
      "type": "blik"
    },
    "customer": {
      "first_name": "John",
      "last_name": "Doe",
      "email": "example@example.com",
      "country": "PL",
      "ip": null
    },
    "manually_corrected_at": null,
    "message": "Transaction was initialized.",
    "test": false,
    "billing_address": {
      "first_name": "John",
      "last_name": "Doe",
      "email": "example@example.com",
      "country": "PL"
    },
    "additional_data": {
      "payment_method": {
        "type": "alternative"
      }
    },
    "gateway": {
      "iframe": true
    },
    "form": {
      "action": "https://payment.ts.com/Order207723170543",
      "method": "GET",
      "fields": []
    }
  }
}