Integrations
Ready Integrations
Choose the integration pattern that matches your product, marketplace or back-office system.
RESTNeroConnectCommerce
Ready integration options
| Method | Endpoint | Purpose |
|---|---|---|
| REST | Direct REST Integration | Use JSON APIs from your own backend. |
| NeroConnect | Platform Integration | Create connected merchants and use NeroPay-Account. |
| Commerce | Checkout Integration | Create payment intents or payment links from your shop/order system. |
| Back office | Reconciliation Integration | List transactions, payouts, invoices and orders. |
Direct REST integration flow
- Authenticate with a server-side secret key.
- Create a payment intent, hosted payment or payment link.
- Store the returned NeroPay id against your order.
- Process webhook events.
- Retrieve transactions and payouts for reconciliation.
'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": "pi_nero_123",
"status": "pending",
"transaction": {
"id": 6636598,
"status": "pending"
}
}
}NeroConnect integration
Platform integrations should store the connected account id returned by POST /connected-accounts. When creating payments, payouts, products or terminal resources for that merchant, send NeroPay-Account.
Authorization: Bearer PLATFORM_SECRET_API_KEY
Accept: application/json
Content-Type: application/json
NeroPay-Account: NP6454f52b_6165