FaTPay Docs
🇺🇸 English
🇺🇸 English
  • Overview
  • Get Started
    • Onboarding
    • Quickstarts
  • Best Practices
    • Exchanges
    • Crypto Projects
    • Wallets
    • Affiliate Partners
    • NFT
  • Reference
    • Integration Tutorial
      • On-ramp Widget Customization
      • NFT Checkout Widget Customization
      • Interface Customization
      • Widget Themes Gallery
      • Widget Signature
    • API Reference
      • APIs
        • List all cryptocurrencies
        • List all fiat currencies and payment methods
        • Retrieve quoted price
        • List all orders
      • Webhooks
        • Webhook for order events
      • API Signature & Webhook Validation
  • Appendix
    • Demo
      • Widget Signature Demo
      • API Signature Demo
      • Webhook Validation Demo
    • Languages
    • Fiat Currencies
    • Cryptocurrencies (on-ramp)
    • Cryptocurrencies (NFT Checkout)
    • Errors
Powered by GitBook
On this page
  1. Reference
  2. API Reference
  3. Webhooks

Webhook for order events

Webhook notification will be sent by FaTPay to the partner when the order status is changed

PreviousWebhooksNextAPI Signature & Webhook Validation

Last updated 1 year ago

For security reason, we highly recommend the backend system of our partners to of webhook whenever receiving a notification of order status change.

on- ramp order: FaTPay will inform Premium Partners via webhook notifications once the transaction is finished on blockchain.

NFT order: FINISHED Settledvia webhook notifications.

Webhook for order events

POST Domain_of_partners_backend/webhook_URI

Webhook notification will be sent by FaTPay to the partner when the order status is changed

Headers

Name
Type
Description

X-FP-Partner-Id*

String

Partner ID assigned by FaTPay as Premium Partner e.g. 2yQrS9A0xmM8xpfa

X-FP-Nonce*

Integer

Random integer e.g. 868964

X-FP-Timestamp*

Integer

Unix timestamp in second e.g. 1661346861

X-FP-Signature*

String

generated by FaTPay. Need to be validated by the partner. E.g. zbBQ+1nv/5up9riH1wbTSSMmkb26LQj3g1cNWsutOordOrtpk8agcA5D5bdYaGeVlHK0qZ2MlUV+ZfOK9cXMuficeIm5fnEjMEm7s1IZtSivMt5te7EFqe52dtVFafE4hUgwqH6QBZB0yZ1FSqHs2dOCI0e8RKJQBDitxtHkibStl1Jt5wulzzq96qWbbVnwoBqGDT52OtwwEcDqMI4SIAzUAdBhAuLqUig1U4Ne9ufT8B1aAohEk5fvn/Sbom21bEjLdgbt5PwH2wmmuBx4tq31IgcP4V+qEBILY2eMAFzkvxNXaX3PsLbj9NpgyIc3HQl0FtRq3gdN7FsSvyvcWA==

Request Body

Name
Type
Description

order*

Object

An object.

Currently, there is no response expected from the partners for webhook. The webhook notification would be sent only once since there is no retry mechanism. Please refer to [List all orders] to confirm the order status.

validate the signature
Signature
Order