Onerway
POST

RDR enrollment status webhook

View as Markdown
Webhook URL
Receive RDR enrollment status changes at the notification URL configured in the merchant portal.

Signature coverage

Request signing guide

All payload fields are included in the signature except:

  • sign(signature value)

Webhook payload fields

idnumber
Enrollment application ID.
Constraints
Rule
This JSON number can exceed the JavaScript safe integer range. Use lossless JSON parsing to preserve its full decimal value for signature verification and acknowledgement.
Rule
Different status changes for the same application can carry the same id. Do not use this field alone to deduplicate notifications.
merchantNonumber
Merchant number assigned by Onerway, identifying the merchant account.
preDisputeServicestring
Service associated with the enrollment application. Always RDR.
Allowed values
RDR
RDR (Rapid Dispute Resolution).
binstring
Acquirer BIN (Bank Identification Number), identifying the institution that provides acquiring services to the merchant.
caidstring
Card Acceptor ID (CAID) provided in the enrollment application.
mccstring
Merchant Category Code (MCC) provided in the enrollment application.
dbastring
Merchant doing-business-as name provided in the enrollment application.
resellerSubMerchantIdstring
Sub-merchant identifier assigned by the agency operator.
arnstring
Acquirer Reference Number (ARN) provided in the enrollment application.
fromEnrollmentStatusstring
Enrollment status before this change.
Allowed values
PENDING_SUBMISSION
Pending submission.
SUBMITTED_AND_PENDING_ENROLLMENT
Submitted and pending enrollment.
ENROLLING
Enrolling.
enrollmentStatusstring
Enrollment status after this change.
Allowed values
PENDING_SUBMISSION
Pending submission.
SUBMITTED_AND_PENDING_ENROLLMENT
Submitted and pending enrollment.
ENROLLING
Enrolling.
Constraints
Rule
Do not assume that every enrollment status change triggers a notification.
notesstring
Application or status transition note.
commentsstring
Review comments for the enrollment application.
createOprstring
Operator recorded as the creator of the enrollment application.
createTimestring
Enrollment application creation time.
Constraints
Rule
Formatted as yyyy-MM-dd HH:mm:ss.
updateOprstring
Operator recorded for the most recent update to the enrollment application.
updateTimestring
Enrollment application update time.
Constraints
Rule
Formatted as yyyy-MM-dd HH:mm:ss.
signstringSignature field · Excluded from signature
Notification signature. Verify it with the SECRET for the current environment using the Payments signing algorithm.
Constraints
Rule
Exclude sign itself when calculating the signature.

Webhook example

{
  "id": 100002,
  "merchantNo": 100000,
  "preDisputeService": "RDR",
  "bin": "replace_with_bin",
  "caid": "demo_card_acceptor_id",
  "mcc": "5999",
  "dba": "EXAMPLE STORE",
  "resellerSubMerchantId": "demo_sub_merchant_001",
  "arn": "demo_acquirer_reference_number",
  "fromEnrollmentStatus": "SUBMITTED_AND_PENDING_ENROLLMENT",
  "enrollmentStatus": "ENROLLING",
  "notes": null,
  "comments": "Example review approved",
  "createOpr": "demo_creator",
  "createTime": "2026-09-01 10:00:00",
  "updateOpr": "demo_reviewer",
  "updateTime": "2026-09-01 10:10:00",
  "sign": "replace_with_sha256_signature"
}

Acknowledgement

After verifying the signature and accepting the notification, return HTTP 200 with Content-Type: text/plain. The response body must contain the received id value unchanged, with no loss of precision. If Onerway does not receive a successful response, it retries at 30-minute intervals, up to 3 times.

Response body example

HTTP 200
100002

Ethoca enrollment status webhook

Ethoca enrollment status changes, payload fields, signature verification, and acknowledgement requirements.

Refund result webhook

Reports a refund result (txnType=REFUND) to the original transaction’s notifyUrl.