Ready plugin guide
PrestaShop Integration
Connect PrestaShop to NeroPay using server-side API calls and webhooks.
PrestaShopCheckoutWebhooks
Recommended PrestaShop flow
- Create or open the PrestaShop order/invoice.
- Send a NeroPay API request from the server side.
- Store the returned NeroPay id on the PrestaShop order/invoice record.
- Redirect the customer or display the payment link.
- Receive webhook confirmation and update the order/invoice status.
POST
/paymentsCreate the NeroPay payment for a PrestaShop order or invoice.
| Parameter | Type | Required | Description |
|---|---|---|---|
identifier | string | Yes | Unique order or invoice reference from PrestaShop. |
amount | decimal | Yes | Order total in major currency units. |
currency | string | Yes | Currency code from the order. |
details | string | Yes | Order or invoice description. |
success_url | url string | Yes | Return URL after success. |
cancel_url | url string | Yes | Return URL after cancellation. |
ipn_url | url string | Yes | Webhook URL handled by the plugin. |
metadata | object | Optional | Short references such as order id, invoice id or customer id. |
'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . $secretKey,
'Accept: application/json',
'Content-Type: application/json',
'X-NeroPay-Timestamp: ' . $timestamp,
'X-NeroPay-Signature: ' . $signature,
'Idempotency-Key: ' . bin2hex(random_bytes(16)),
],
CURLOPT_POSTFIELDS => $rawBody,
]);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $response;
{
"success": true,
"data": {
"id": "pay_nero_123",
"identifier": "PRESTASHOP-1001",
"status": "pending",
"checkout_url": "https://eu.neropay.app/checkout/..."
}
}Webhook update
When transaction.succeeded is received, verify the event, retrieve the transaction if needed and mark the PrestaShop order as paid.
transaction.succeeded => paid
transaction.cancelled => cancelled
transaction.failed => failed
refund.succeeded => refunded