Payments
Network Retry Signals

Simulate a Network Retry Signal

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.

post/payments/network-retry-signals/simulate

Request

Request body

network'mastercard' | 'visa'

The network to simulate the signal from. Optional. Defaults to 'mastercard'.

networkMidstring

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.

Example request

{
  "network": "mastercard",
  "networkMid": "12354689987"
}

Response

Returns the simulated Network Retry Signal sent to your webhook.

networkstring required

The signal origin network.

signal'retry-now' required

The signal type.

amountnumber required

The declined transaction amount in minor units.

networkTransactionIdstring required

The network transaction ID of the declined transaction.

timestampstring required

The timestamp of the declined transaction.

Example response

{
  "network": "mastercard",
  "signal": "retry-now",
  "amount": 1000,
  "networkTransactionId": "W3T51Z",
  "timestamp": "2026-02-04T13:53:47.314Z",
  "currency": {
    "alphaCode": "usd",
    "numericCode": 840
  },
  "metadata": {
    "notificationId": "M8OjZWZgRi0uZLa6PdB0CIavqctFyipx",
    "acquirerMerchantId": "12354689987",
    "cardBin": "5123456",
    "cardLastFour": "9000",
    "tokenBin": "5234567",
    "tokenLastFour": "1234",
    "maskedCardNumber": "512345XXXXXX9000"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.