Onerway
POST

Submit RDR enrollment

View as Markdown
Use this endpoint to submit an RDR enrollment application and receive the application ID for later status queries or transitions.

Request

merchantNostringrequired
Merchant number assigned by Onerway. When an agency operator submits the application for a sub-merchant, use the agency operator merchant number.
Example:replace_with_merchant_no
preDisputeServicestringrequired
Service to enroll in. RDR (Rapid Dispute Resolution) is Visa’s dispute-prevention service for Visa card transactions. After the merchant configures handling rules, eligible disputes can be processed automatically before they become chargebacks.
Example:RDR
Allowed values
RDR
Visa Rapid Dispute Resolution service.
Constraints
Values
Submit RDR for this endpoint.
binstringrequired
Acquirer BIN (Bank Identification Number), identifying the institution that provides acquiring services to the merchant.
Example:replace_with_bin
dbastringrequired
Merchant doing-business-as name displayed to cardholders on statements or transactions. When an agency operator applies for a sub-merchant, provide the sub-merchant actual trading name.
Example:EXAMPLE STORE US
caidstringrequired
Card Acceptor ID (CAID), assigned by the acquirer to identify the merchant and its transactions on the card-network side.
Example:replace_with_card_acceptor_id
mccstringrequired
Merchant Category Code (MCC), a four-digit card-network code identifying the merchant business category.
Example:5999
arnstringrequired
Acquirer Reference Number (ARN), the unique tracking number for a transaction as it moves between the acquirer and card network.
Example:replace_with_acquirer_reference_number
resellerSubMerchantIdstringoptional
Condition: Provide this field when an agency operator applies for a managed sub-merchant.
Sub-merchant identifier assigned by the agency operator.
Example:demo_sub_merchant_001
Constraints
Consistency
The same agency operator merchantNo can enroll multiple sub-merchants. Assign a unique resellerSubMerchantId to each sub-merchant so each RDR application remains independent.
notesstringoptional
Application note for special requirements or supplementary information.
Example:Open RDR service
commentsstringoptional
Review comment field. Leave it empty for merchant-submitted applications; use notes for supplementary information.
Constraints
Rule
Leave this field empty for merchant-submitted applications. Use notes for supplementary information.
signstringrequired
Request signature string. See Request signing for how to generate it.

Request example

curl -X POST 'https://sandbox-acq.onerway.com/rdr/agency-cw/enrollment/submit' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "arn": "replace_with_acquirer_reference_number",
  "bin": "replace_with_bin",
  "caid": "replace_with_card_acceptor_id",
  "dba": "EXAMPLE STORE US",
  "mcc": "5999",
  "merchantNo": "replace_with_merchant_no",
  "notes": "Open RDR service",
  "preDisputeService": "RDR",
  "resellerSubMerchantId": "demo_sub_merchant_001",
  "sign": "{{SIGN}}"
}'

Response

respCodestring
20000 means the enrollment application was submitted and accepted for processing. It does not mean the RDR service has been enabled. The service becomes active only after review and the enrollment reaches ENROLLED. Confirm the final state through Query RDR enrollments or the RDR enrollment status webhook. Other values are error codes. See Response codes.
respMsgstring
Human-readable message for the response code.
Business data object containing the enrollment application ID.

Response example

Example code is unavailable.

No error responses are documented for this endpoint.

Submit Ethoca alert outcome

Submit the handling outcome and refund status for an Ethoca alert.

Query RDR enrollments

Query RDR service enrollment records and their current lifecycle status.