Skip to content

Bizum

EPA Integration option

Payment

Payment flow

  1. The customer initiates the payment on the merchant's website.
  2. The merchant sends the payment request to PaySage.io.
  3. PaySage.io sends a response containing the URL for completing the payment.
  4. The merchant redirects the customer to the provided URL.
  5. The customer completes the payment.
  6. PaySage.io sends a webhook notification with the payment status to the merchant. The merchant may also request the payment status from PaySage.io with the status query.
Request

Send a payment request with the following additional parameters:

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.
type * required
 string bizum
customer object A section of information about the customer.
email string The customer's email address.
Request example 
{
    "request": {
        "amount": 200,
        "currency": "EUR",
        "description": "test description",
        "test": false,
        "tracking_id": "your_uniq_number",            
        "language": "en",
        "notification_url": "https://your-notification.url",
        "return_url": "https://your-success.url",
        "method": {
            "type": "bizum"
        }
    }
}
Response

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

Response example 
{
    "transaction": {
        "uid": "e678de4a-a781-4b03-bdd4-8e3738a6db61",
        "type": "payment",
        "status": "pending",
        "amount": 200,
        "currency": "EUR",
        "description": "test description",
        "created_at": "2025-03-19T19:15:24Z",
        "updated_at": "2025-03-19T19:15:24Z",
        "method_type": "bizum",
        "receipt_url": "https://backoffice.paysage.io/customer/transactions/e678de4a-a781-4b03-bdd4-8e3738a6db61/a78be95d3fac367d0c217d1da144ee868b719e93f9d3f16704c50aaaff785200?language=en",
        "payment": {
            "status": "pending",
            "gateway_id": 5117,
            "ref_id": "08023912",
            "message": "Pending"
        },
        "bizum": {
            "type": "bizum"
        },
        "customer": {
            "email": null,
            "ip": null
        },
        "manually_corrected_at": null,
        "version": 0,
        "message": "Pending",
        "tracking_id": "your_uniq_number",
        "test": false,
        "language": "en",
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },        
        "gateway": {
            "iframe": false
        },
        "form": {
            "action": "payment_url",
            "method": "GET",
            "fields": []
        }
    }
}