Skip to content

Boodil

SQ Integration option

Payment

Payment Flow

  1. The customer initiates a payment on the merchant's website.
  2. The merchant sends a payment request to the PaynetworkGate.
  3. PaynetworkGate 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. PaynetworkGate sends a webhook notification with the payment status to the merchant. In the rare cases the status of the transaction can be changed from failed to successful. In this case, PaynetworkGate will send another webhook notification with the updated status to the merchant.
  7. The merchant displays the payment status to the customer.

Info

This integration option supports only `GBP` 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 boodil
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.
Request example 
{
    "request": {
        "amount": 100,
        "currency": "EUR",
        "description": "description",
        "test": true,
        "return_url": "https://merchant.ltd/return",
        "customer": {
            "first_name": "Ioanna",
            "last_name": "Johnson",
            "email": "example@example.com"
        },
        "method": {
            "type": "boodil"
        }
    }
}
Response

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

Response example 
{
    "transaction": {
        "uid": "05282e76-3a8f-4238-a8bb-8c639ad84035",
        "type": "payment",
        "status": "pending",
        "amount": 100,
        "currency": "EUR",
        "description": "description",
        "created_at": "2024-10-04T08:58:08Z",
        "updated_at": "2024-10-04T08:58:08Z",
        "method_type": "boodil",
        "receipt_url": "https://backoffice.paynetworks.io/customer/transactions/05282e76-3a8f-4238-a8bb-8c639ad84035/6b4d1f27b5302a61c18966135998e1cc663184c2c430e2a4e3ab5fe5d630a485",
        "payment": {
            "status": "pending",
            "gateway_id": 4539,
            "ref_id": "400f27fb-a09d-4974-85a0-e6d855601fee",
            "message": "Transaction was initialized."
        },
        "boodil": {
            "type": "boodil"
        },
        "customer": {
            "first_name": "Ioanna",
            "last_name": "Johnson",
            "email": "example@example.com",
            "ip": null
        },
        "manually_corrected_at": null,
        "version": 0,
        "message": "Transaction was initialized.",
        "test": true,
        "billing_address": {
            "first_name": "Ioanna",
            "last_name": "Johnson",
            "email": "example@example.com"
        },
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },       
        "gateway": {
            "iframe": true
        },
        "form": {
            "action": "https://sq-payment-page/400f27fb-a09d-4974-85a0-e6d855601fee",
            "method": "GET",
            "fields": []
        }
    }
}