simulate incoming message (sandbox only)

post

https://api.sandbox.zeptopayments.com/investigations/simulate_incoming_message

Simulate an incoming dispute message in sandbox environment

Body Params

simulate_action_request

boolean

required

Flag to trigger the action_requested webhook. When enabled, investigation_type_code must be INV13 or INV14.

investigation_type_code

string

enum

required

The type of investigation to be simulated.

Allowed:

investigation_reason_code

string

required

The reason code for the investigation (eg from the ISO20022 ExternalReturnReason1Code set).

original_transaction_identification

string

required

The original transaction identification related to the investigation. It must relate to a PayTo payment submission for a mandate owned by the merchant.

narrative

string

required

The narrative for the investigation (freeform text, slash-delimited). It is omitted from the message_received webhook but is included in action_requested webhook.

Headers

Zepto-API-Version

string

Defaults to 20250101

API version in YYYYMMDD format. Defaults to 20250101 (legacy) when omitted.

Responses

Language

Credentials

Bearer

URL

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200OK

400Bad Request