---
title: "Simulate a Network Retry Signal"
method: POST
path: "/payments/network-retry-signals/simulate"
tags: ["Payments", "Network Retry Signals"]
---

# Simulate a Network Retry Signal

`POST /payments/network-retry-signals/simulate`

## Request

- Base URL: `https://api.evervault.com`
- URL: `https://api.evervault.com/payments/network-retry-signals/simulate`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/evervault/apis/evervault-api/docs/payments/network-retry-signals/simulate/post.ts> (a function with typed inputs; its response is checked against the schema)

Simulates a Network Retry Signal so you can test your webhook handling without a
Network Retry Signal Enrolment. The signal is generated with random values and sent
to your app's webhook as a `payments.network-retry-signals.signal` event.

This endpoint is only available for [Sandbox Apps](/developers/sandbox).

## Request body

- object
  - `network` 'mastercard' | 'visa': The network to simulate the signal from. Optional. Defaults to 'mastercard'.
  - `networkMid` string: The Merchant Identifier (MID) to use as the `acquirerMerchantId` of the signal. Optional. A random MID is used if omitted. Can only be set for `mastercard` signals.

## Response `202`

Returns the simulated Network Retry Signal sent to your webhook.

- NetworkRetrySignal
  - `network` string, required: The signal origin network.
  - `signal` 'retry-now', required: The signal type.
  - `amount` number, required: The declined transaction amount in minor units.
  - `networkTransactionId` string, required: The network transaction ID of the declined transaction.
  - `timestamp` string, required: The timestamp of the declined transaction.
  - `currency` object, required: The currency of the declined transaction.
    - `alphaCode` string: The ISO 4217 alpha code of the currency.
    - `numericCode` number: The ISO 4217 numeric code of the currency.
  - `metadata` union, required: The metadata of the Network Retry Signal. Its shape depends on the `network`.
    - object
      - `notificationId` string: The card network's unique reference for this specific signal.
      - `acquirerMerchantId` string, required: The acquirer merchant ID.
      - `cardBin` string: The card BIN.
      - `cardLastFour` string: The last four digits of the card number.
      - `tokenBin` string: The token BIN.
      - `tokenLastFour` string: The last four digits of the token number.
      - `maskedCardNumber` string: The masked card number.
    - object
      - `invoiceNumber` string, required: The invoice number of the declined transaction.

## Other responses

- `400`: The request is invalid, for example a `networkMid` was given for a `visa` signal.
- `403`: Simulations are only available for sandbox apps with Network Retry Signals enabled.

## Changes

- **2026-11-06** `8d0ca833fa04`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/evervault/apis/evervault-api/changes/payments/network-retry-signals/simulate/post.md)

---

[API](https://skmtc.dev/evervault/apis/evervault-api.md) - [All operations](https://skmtc.dev/evervault/apis/evervault-api/llms.txt) - [OpenAPI document](https://skmtc.dev/evervault/apis/evervault-api/revisions/8d0ca833fa04?raw)