Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.iterapay.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Use this endpoint to configure a webhook URL for your merchant. IteraPay will send event notifications to this URL when payment and withdrawal activity occurs. If a webhook already exists, this call replaces it with the new configuration.
The endpoint path is /weebhook/{merchantID} — note the double ‘e’. Use this exact path in your requests.
This endpoint requires Bearer token authentication. API key authentication is not accepted.

​
Path parameters

​
merchantID
string
required
The UUID of the merchant for which to configure the webhook.

​
Request body

​
url
string
required
The HTTPS URL on your server where IteraPay should deliver webhook events. Must be a publicly reachable endpoint.
​
secret
string
required
A secret string used to generate a signing token for verifying webhook payloads. Choose a strong, random value and store it securely.

​
Response

Returns a 200 OK with a webhook signing token on success.
​
token
string
A webhook signing token derived from your secret. Use this value to verify the authenticity of incoming webhook payloads by comparing it against the signature header sent with each event.
curl --request POST \
  --url https://api.iterapay.com/weebhook/b0fcc813-a7ce-4bbc-932f-dbef6f59ca7f \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "url": "https://yoursite.com/webhooks/iterapay",
    "secret": "your-webhook-secret"
  }'

{
  "token": "whsec_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0"
}