LogoLogo
  • General
    • Welcome to 0xpay
    • Transaction Fees
    • Networks & Assets
  • Integration Cookbook
    • Getting Started
      • Merchant Setup
    • Receive assets
    • Send assets
    • Invoices
    • Exchanges
  • Public API
    • Authorization
      • Signature Examples
    • Endpoints
      • Merchant
      • Basic crypto operations
      • Crypto Invoices
      • Basic Fiat Operations
      • Fiat Invoices
      • Exchange
      • Exchange + Withdrawal
    • Notifications
      • Crypto Callbacks
      • Fiat Callbacks
      • Exchange Callbacks
    • JS/TS SDK
      • Getting started
      • Processing WebHook Notifications
      • Reference
  • Legal Info
    • Terms of Service
      • ANNEX 1: RISK DISCLOSURE
      • ANNEX 2: PROHIBITED BUSINESSES
      • ANNEX 3: HIGH-RISK STATES, TERRITORIES AND JURISDICTIONS
    • Privacy Policy
Powered by GitBook
On this page
  1. Public API

Notifications

PreviousExchange + WithdrawalNextCrypto Callbacks

Last updated 1 year ago

Notifications (a.k.a "Callbacks", "IPN") are used in 0xpay to alert users about events happenning to their merchants. Whenever something happens to your merchant, 0xpay will try to send a webhook to the Notifications URL that you've previously specified in .

Webhooks require authorization on your side, in order to verify the validity of message received.

We guarantee that webhooks will come in described order, according to their tx status change.

For example: we won't send you a "Done" status webhook until you respond with success HTTP status to a "Pending" webhook that was sent earlier.

Notifications retry timeline:

In case your URL responds with a non-success HTTP status – the notification will be retried 10 times, with initial delay of 10 minutes, each new retry triggered 15 minutes later, up to a maximum of 60 minutes. In total, we are going to try and notify you for 8 hours.

Number of Retries
Timeout

Retry #1

10 min

Retry #2

25 min

Retry #3

40 min

Retry #4

55 min

Retry #5-10

60 min

Check out notification examples on the next page.

merchant settings