POST
Submit Ethoca enrollment
Use this endpoint to submit an Ethoca alert-service enrollment application and receive the application ID for later status queries or transitions.
Request
merchantNoMerchant 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_nopreDisputeServiceAlert service type to enroll.
Example:
ETHOCA_ALERTAllowed values
ETHOCA_ALERT- Ethoca alert service. Ethoca is a Mastercard-owned alert network covering Mastercard, American Express, Discover, and, in some regions, Visa.
Constraints
- Values
- Submit
ETHOCA_ALERTfor this endpoint.
billDescMerchant billing descriptor shown on the cardholder bank statement. Use the actual merchant trading name and keep it consistent with the acquirer-facing billing descriptor so cardholders and issuers can recognize the transaction and Ethoca can match alerts to the merchant.
Example:
EXAMPLE STORE USresellerSubMerchantIdCondition: 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_001Constraints
- Consistency
- The same agency operator
merchantNocan enroll multiple sub-merchants. Assign a uniqueresellerSubMerchantIdto each sub-merchant.
notesApplication note for special requirements or supplementary information.
Example:
Open Ethoca alert servicesignRequest signature string. See Request signing for how to generate it.
curl -X POST 'https://sandbox-acq.onerway.com/ethoca/agency-cw/enrollment/submit' \
-H 'Content-Type: application/json' \
--data-raw '{
"billDesc": "EXAMPLE STORE US",
"merchantNo": "replace_with_merchant_no",
"notes": "Open Ethoca alert service",
"preDisputeService": "ETHOCA_ALERT",
"resellerSubMerchantId": "demo_sub_merchant_001",
"sign": "{{SIGN}}"
}'Response
respCode20000 means the enrollment application was submitted and accepted for processing. It does not mean the service has been enabled. Confirm the final state through Query Ethoca enrollments or the Ethoca enrollment status webhook. Other values are error codes. See Response codes.respMsgHuman-readable message for the response code.
data{ id, sign }Business data object containing the enrollment application ID.
Response example
Example code is unavailable.
No error responses are documented for this endpoint.