PUT
/
Notification
/
{nId}

Authorizations

requestToken
string
header
required

Most endpoints require an organization token. Some endpoints require an application token, and those endpoints are noted.

Path Parameters

nId
string
required

Notification ID.

Body

Information about the standard notification configuration (email, sms, web).

frequency
enum<string>
required
Available options:
one-time,
untilcancelled
method
enum<string>
required

Get near-instant notifications via email, SMS, or webhooks for important events like new payment disputes, merchant activations, fraud alerts, approved transactions, settlement history, vendor payouts, and more. Use webhooks with notifications to get real-time updates and automate operations based on key those key events. See Notifications for more.

Available options:
email,
sms,
web
ownerId
string | null
required

ID for the paypoint or organization that owns the notification.

ownerType
enum<integer>
required

Entity owner type. Accepted values:

  • 0: Organization/partner
  • 2: Paypoint
Available options:
0,
2
target
string
required

Specify the notification target.

  • For method=email the expected value is a list of email addresses separated by semicolon.
  • For method=sms the expected value is a list of phone numbers separated by semicolon.
  • For method=web the expected value is a valid and complete URL. Webhooks support only standard HTTP ports: 80, 443, 8080, or 4443.
content
object
status
enum<integer> | null

Status of notification:

  • 0: Inactive
  • 1: Active
Available options:
0,
1

Response

200 - application/json
isSuccess
boolean

If isSuccess = true, responseData contains the notification identifier.

If isSuccess = false, responseData contains the reason for the error.

pageIdentifier
string | null

Auxiliary validation used internally by payment pages and components.

responseCode
integer | null

Code for the response. Learn more in API Response Codes.

responseData

When the request was successful, this contains the notification ID, or nID used to manage the notifcation.

responseText
string | null

Response text for operation: 'Success' or 'Declined'.