Skip to main content
Use this endpoint to restrict API key usage to a specific IP address. When an IP address restriction is set, any API key request that does not originate from the configured address will be rejected, providing an additional layer of security for your integration.
IP address restrictions apply to API key authentication only. Bearer token requests are not affected by this setting.
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 IP address restriction.

Request body

ipAddress
string
required
The IPv4 address to allowlist. Only requests from this address will be accepted when authenticating with an API key for this merchant.

Response

Returns 204 No Content on success. No response body is returned.
curl --request POST \
  --url https://api.iterapay.com/ipAddress/b0fcc813-a7ce-4bbc-932f-dbef6f59ca7f \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "ipAddress": "203.0.113.42"
  }'
(no content)