TruBit Business
πŸ‡ΊπŸ‡Έ EN 2025/05/08
πŸ‡ΊπŸ‡Έ EN 2025/05/08
  • πŸ“– Guides
    • A Gentle Introduction
    • Step-by-Step Guide
    • Creating TruBit Account
    • Creating API Key
      • Safely Store Your API Key
      • Configure Whitelisted IPs
      • Enable API Access
      • Create API Token
    • Sandbox
    • Creating Your Merchant
    • Creating Payment Method
    • Payment Method ID
    • Currencies
    • Pair
    • Creating Webhook Listener
    • Fiat to Crypto (On-Ramp)
    • Crypto to Fiat (Off-Ramp)
    • Fiat to Fiat (Global Payment)
  • πŸ“— API Reference
    • Basic Configuration
      • API Endpoint
      • Get List of Countries
      • Get List of Fiat Currencies
      • Get List of Crypto Currencies
      • Get Fiat/Crypto Pairs
      • Get Crypto/Fiat Pairs
      • Get Fiat/Fiat Pairs
      • Get Fiat/Crypto Payment Methods
      • Get Crypto/Fiat Payment Methods
      • Get Fiat/Fiat Payment Methods
    • Account
      • Get Account Details
      • Get Crypto Assets Balance
      • Get Crypto Deposit Address
    • Merchant
      • Add Merchant
      • Get a List of Merchants
      • Get a List of Merchant Accounts
      • Retrieve Pending Fund
      • Claim Pending Fund
      • Get Transfer Pending Funds Fee
      • Transfer Pending Funds
      • Retrieve Funding Records
    • Quote
      • Get User Quote for Crypto/Fiat
      • Get User Quote for Fiat/Fiat
    • Payment Method
      • Get Payment Templates
      • Add Payment Method
      • Get Payment Method
      • Delete Payment Method
      • Set Refund Account
    • Order
      • Create a Fiat to Crypto Order
      • Create a Crypto to Fiat Order
      • Create a Fiat to Fiat Order
      • Confirm a Specific Order
      • Retrieve a Specific Order
      • Retrieve a List of Orders
      • Upload Invoice Documents For a Specific Order
    • Webhooks
      • Create Webhook Endpoints
      • Get Webhook Endpoints
      • Update a Webhook
      • Delete a Webhook
      • Fiat/Crypto Order Message Push
      • Fiat/Fiat Order Message Push
      • Funding Records Message Push
  • πŸ› οΈ Error Reference
    • Error and Warning Dictionary
  • πŸͺ„Changelog
    • πŸ••Changelog
Powered by GitBook
On this page
  1. πŸ“— API Reference
  2. Webhooks

Fiat/Fiat Order Message Push

This API allows you to push global payment order notifications to a specified webhook.

Endpoint Information

  • Request Method: POST

  • Request Path: (Specify the appropriate path for your webhook notifications)

Request Body Parameters

The request body should include the following fields:

{
    "webhookId": "ebab8a9663704e7cbbebe672c7c67912",  // (string: ID of the webhook)
    "eventType": "GLOBAL_PAYMENT_WEBHOOK",            // (string: event type [GLOBAL_PAYMENT_WEBHOOK])
    "orderId": "473130522693193728",                  // (string: ID of the order)
    "clientId": "W658784738723",                      // (string: ID of the client)
    "userId": "455472",                               // (string: ID of the user)        
    "onRampCountry": "Mexico",                        // (string: name of the on-ramp country)
    "onRampMerchantId": 3,                            // (number: ID of the on-ramp merchant id)
    "onRampFiat": "MXN",                              // (string: name of the on-ramp fiat currency)
    "onRampFiatAmount": "100.00",                     // (decimal: amount of on-ramp fiat currency)
    "onRampFiatFee": "0",                             // (decimal: amount of on-ramp fiat fee)    
    "offRampCountry": "Hong Kong",                    // (string: name of the off-ramp country)
    "offRampMerchantId": 4,                           // (number: ID of the off-ramp merchant id)
    "offRampFiat": "USD",                             // (string: name of the off-ramp fiat currency)
    "offRampFiatAmount": "18.00",                     // (decimal: amount of off-ramp fiat currency)
    "offRampFiatFee": "2.00",                         // (decimal: amount of off-ramp fiat fee)    
    "orderPrice": "20.00",                            // (decimal: price of the order)
    "orderStatus": "41",                              // (string: order status [10, 30, 31, 41, 51, 60, 71, 72])
    "createTime": "1735279907000",                    // (string: timestamp of the create time in milliseconds)
    "updateTime": "1735280582000"                     // (string: timestamp of the update time in milliseconds)
}

Response Structure

The response will include the following fields:

{
    "callbackStatus": "SUCCESS"                       // (string: callback status, indicates if the message was successfully notified)
}

Example Request

{
    "webhookId": "ebab8a9663704e7cbbebe672c7c67912",
    "eventType": "GLOBAL_PAYMENT_WEBHOOK",
    "orderId": "473130522693193728",
    "clientId": "W658784738723",
    "userId": "455472",
    "onRampCountry": "Mexico",
    "onRampMerchantId": 3,
    "onRampFiat": "MXN",
    "onRampFiatAmount": "100.00",
    "onRampFiatFee": "0",
    "offRampCountry": "Hong Kong",
    "offRampMerchantId": 4,
    "offRampFiat": "USD",
    "offRampFiatAmount": "18.00",
    "offRampFiatFee": "2.00",
    "orderPrice": "20.00",
    "orderStatus": "41",
    "createTime": "1735279907000",
    "updateTime": "1735280582000"
}

Example Response

{
    "callbackStatus": "SUCCESS"
}

Notes

  • Ensure that the webhook URL is properly configured to receive and process the notification.

  • The callbackStatus indicates whether the message was successfully sent to the webhook. If it shows SUCCESS, the notification was sent without issues.

PreviousFiat/Crypto Order Message PushNextFunding Records Message Push