Set up payment notifications
Add a webhook endpoint, test delivery, and find the reason a notification failed.
Webhooks tell your application when a payment or wallet event happens. Open Developers → Webhooks to manage the destination and see each delivery attempt.
Add your endpoint
Choose Add endpoint
Enter the HTTPS URL your developer prepared and an optional description. The URL must resolve to a public address and use port 443 or 8443. If a business domain is verified, webhook URLs must be on that domain.
Choose events
Select the event types the application needs. Leaving the event list empty subscribes the endpoint to every event type, including types introduced later.
Store the signing secret
The signing secret appears once when the endpoint is created. Store it with your application's secrets. Your developer uses it to check that each notification came from MolnPay.
Send a test
Choose Send test, then check the Delivery log. Open the delivery to see whether your server accepted it. A successful response means the notification reached your endpoint.
Investigate a failed delivery
Open a row in the delivery log. Check the receiver's response and error detail. Your developer can use the delivery ID and event ID to investigate. MolnPay retries failed deliveries; persistent failures can disable the endpoint.
Fix the destination before replaying a delivery or re-enabling an endpoint. Replay availability depends on your plan and permissions. See Manage endpoints for the full behavior.
Pause or replace a secret
Use Pause to stop an endpoint temporarily and Resume to start it again. If the signing secret is lost, rotate it. During the configured overlap, either secret can verify a delivery, giving your developer time to update the application.
Developers should follow Verify a signature and the webhook contract before using events to fulfill orders.