BlockaPay IPN Documentation

Payment Response

BlockaPay callback sends following data

• item_name - Name of the payment item.
• item_number - Number of the payment item.
• payee_email - Email address that received this payment.
• payment_currency - The currency in which the payment was made (e.g., USD, EUR, GBP).
• payment_amount - The full amount paid.
• notify_url - The URL of the payment process page.
• return_url - The URL of the payment success page.
• cancel_url - The URL of the payment cancel/failed page.
• custom - Custom field data passed. 'custom' is passed as a serialized array, so unserialize it and use:
  $custom = unserialize($_POST['custom']);
$customfield1 = $custom['custom1'];
$customfield2 = $custom['custom2'];
$customfield3 = $custom['custom3'];

Integration Guide

To integrate the Instant Payment Notification (IPN) functionality into your website, follow these steps:

1. Create a payment form on your website with the necessary fields, including the item name, item number, payment amount, payer email, etc.
2. Set the form action URL to the IPN URL provided by BlockaPay:

1. Handle the IPN response on your server using the provided payment response array. Extract the required information from the array to process the payment accordingly.
2. Validate the payment status and transaction ID to ensure the payment is legitimate and successful.
3. Perform any necessary backend operations, such as updating the order status, sending email notifications, etc.
4. Redirect the user to the appropriate success or failure page based on the payment status.