# Order Matched Notification

This sends a notification to the third-party application when an order is placed to be sold or bought by a customer. This is done using the `POST` method. See examples and descriptions below;

```json
{
  "CheckSum": "E8A935C3BDE4E47938A01CA3C2166A6B256733CF2E91E1FDE0473F693999BADCCA5C30E9F0D8A7CF61CFEEC2FC58CFB3EAEFD2754D16BA0EB5314ACFF01A67CA",
  "Data": {
    "OrderReference": "XB_37a483f890dc4c1bb9f48524c41ad47b",
    "ReceiveInCurrencyCode": 6,
    "PayInCurrencyCode": 1,
    "ReceivableAmount": 0.44364937,
    "PayableAmount": 248,
    "ProviderName": "Nnadozie Ohaeri",
    "ProviderFirstName": "Nnadozie",
    "ProviderLastName": "Ohaeri",
    "ProviderEmail": "dozienna4@gmail.com",
    "InitiatedAt": "2022-02-08T13:02:42.1580578Z",
    "OrderExpiryDate": "2022-02-08T13:16:40.1541528Z",
    "InitiatedAtTimestamp": 1644325300154,
    "OrderExpiryTimestamp": 1644326200154,
    "FundedProviderAtTimeStamp": null,
    "FundedCustomerAtTimeStamp": null,
    "OrderCompletedAtTimeStamp": null,
    "P2POrderStatus": 3,
    "DisputeStatus": 1,
    "OrderType": 1,
    "ProviderContact": {
      "PhoneNumber": "2348062069869",
      "WhatsappNumber": "2348062069869"
    },
    "CustomerContact": {
      "Email": "JOHNDOEE@gmail.com",
      "Name": "John Doe",
      "PhoneNumber": "0706346XXXX"
    },
    "ProviderPaymentMethods": {
      "PaymentMethod": 1,
      "PaymentType": 1,
      "PaymentData": [
        {
          "BankName": "Access",
          "AccountNumber": "0069888440",
          "AccountName": "Ohaeri Nnadozie",
          "Currency": "NGN"
        }
      ],
      "OrderPaymentMethod": {
        "BankName": "Access",
        "AccountNumber": "0069888440",
        "AccountName": "Ohaeri Nnadozie",
        "Currency": "NGN"
      }
    },
    "ConsumerDepositMethod": {
      "PaymentMethod": 1,
      "PaymentType": 0,
      "PaymentData": {
        "BankName": "Access Bank",
        "AccountNumber": "0000187849",
        "AccountName": "Emmanuel Diala",
        "Currency": "NGN"
      }
    },
    "ConsumerReceiptMethod": {
      "PaymentMethod": 2,
      "PaymentType": 0,
      "PaymentData": {
        "WalletAddress": "QWEVDTWDGVT462E6EFYE9202Y239",
        "Network": "BEP20",
        "Currency": "BUSD"
      }
    },
    "ProviderTransactionMetadata": null
  }
}
```

<table><thead><tr><th width="270.3333333333333">Key</th><th width="150">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>Checksum</code></td><td>string</td><td>This is a hash property signed with the merchant <code>secretkey</code>.</td></tr><tr><td><code>Data</code></td><td>object</td><td>This holds the properties of the payload data details.</td></tr><tr><td><code>OrderReference</code></td><td>string</td><td>This the reference to a particular order.</td></tr><tr><td><code>RecieveInCurrencyCode</code></td><td>enum</td><td>This is the currency code to receive the currency in.</td></tr><tr><td><code>PayInCurrencyCode</code></td><td>enum</td><td>This is the currency code to pay with.</td></tr><tr><td><code>ReceivableAmount</code></td><td>decimal</td><td>This the receivable amount of the currency.</td></tr><tr><td><code>PayableAmount</code></td><td>decimal</td><td>This is the payable amount of the currency.</td></tr><tr><td><code>ProviderName</code></td><td>string</td><td>This the provider's name.</td></tr><tr><td><code>ProviderFirstName</code></td><td>string</td><td>This is the provider's first name.</td></tr><tr><td><code>ProviderLastName</code></td><td>string</td><td>This is the provider's last name.</td></tr><tr><td><code>ProviderEmail</code></td><td>string</td><td>This is the provider's email address.</td></tr><tr><td><code>InitiatedAt</code></td><td>DateTime</td><td>The date time the order was made.</td></tr><tr><td><code>OrderExpiryDate</code></td><td>DateTime</td><td>The expiry date time of the order.</td></tr><tr><td><code>InitiatedAtTimestamp</code></td><td>long</td><td>The time in milliseconds an order was made</td></tr><tr><td><code>OrderExpiryTimestamp</code></td><td>long</td><td>The time in milliseconds of when thee order will expire.</td></tr><tr><td><code>FundedProviderAtTimeStamp</code></td><td>long</td><td>The time of when a customer indicates payment for an order in milliseconds.</td></tr><tr><td><code>FundedCustomerAtTimeStamp</code></td><td>long</td><td>The time of when a provider indicates payment of order to the customer in milliseconds</td></tr><tr><td><code>OrderCompletedAtTimeStamp</code></td><td>long</td><td>The time in milliseconds an order was completed.</td></tr><tr><td><code>P2POrderStatus</code></td><td>enum</td><td>The status of the order at the curent time. It could be <code>Submitted</code>, <code>Cancelled</code>, <code>Acknowledged</code>, <code>FundedProvider</code>, <code>FundReceivedFromUser</code>, <code>FundedUser</code>, <code>Completed</code>, <code>OrderTimedOut</code></td></tr><tr><td><code>DisputeStatus</code></td><td>enum</td><td>The status of the dispute on an order. It could either be <code>NoDispute</code>, <code>DisputeRaisedByCustomer</code>, <code>DisputeRaisedByProvider</code>, <code>DisputeRaisedByBothParties</code>, <code>DisputeResolved</code>or <code>CouldNotBeResolved</code>.</td></tr><tr><td><code>OrderType</code></td><td>enum</td><td>This is the status of the order, whether it's a <code>Buy</code> or <code>Sell</code>.</td></tr><tr><td><code>ProviderContact</code></td><td>object</td><td>This is holds properties of a provider's contact information.</td></tr><tr><td><code>PhoneNumber</code></td><td>string</td><td>The phone number of either the provider or customer.</td></tr><tr><td><code>WhatsappNumber</code></td><td>string</td><td>The whatsapp number of either the provider or customer.</td></tr><tr><td><code>CustomerContact</code></td><td>object</td><td>This holds the props of the contact information.</td></tr><tr><td><code>Email</code></td><td>string</td><td>This is an email address of the customer.</td></tr><tr><td><code>Name</code></td><td>string</td><td>This is the name of the customer.</td></tr><tr><td><code>PhoneNumber</code></td><td>string</td><td>The phone number of the customer</td></tr><tr><td><code>ProviderPaymentMethods</code></td><td>object</td><td>This holds the properties of the payment methods of the provider.</td></tr><tr><td><code>PaymentMethod</code></td><td>enum</td><td>This is the method of payment. It could be <code>Bank</code> or <code>Crypto</code></td></tr><tr><td><code>PaymentType</code></td><td>enum</td><td>This is the type of payment. It could be <code>Bank</code>, <code>Crypto</code>, <code>UserName</code>or <code>MobileMoney</code>.</td></tr><tr><td><code>PaymentData</code></td><td>object</td><td>This holds the properties of the payment method.</td></tr><tr><td><code>BankName</code></td><td>string</td><td>The bank name of the the provider or customer.</td></tr><tr><td><code>AccountNumber</code></td><td>string</td><td>The bank account number of the provider or customer.</td></tr><tr><td><code>AccountName</code></td><td>string</td><td>The bank account name of the provider or customer.</td></tr><tr><td><code>Currency</code></td><td>enum</td><td>The currency in which the order was made. It could be <code>BUSD</code> or <code>NGN</code>.</td></tr><tr><td><code>OrderPaymentMethod</code></td><td>object</td><td>This holds properties of the payment method in which the order is to be made to.</td></tr><tr><td><code>ConsumerDepositMethod</code></td><td>object</td><td>This holds the props of the consumer deposit details.</td></tr><tr><td><code>ConsumerrReceiptMethod</code></td><td>object</td><td>This holds the properties of the consumer receiving method details.</td></tr><tr><td><code>WalletAddress</code></td><td>string</td><td>This is the crypto wallet address of the consumer.</td></tr><tr><td><code>Network</code></td><td>enum</td><td>This is the network currently supported in the system which the wallet address is based on.</td></tr><tr><td><code>ProviderTransactionMetadata</code></td><td>object</td><td>This holds the properties of the transaction metadata of an order. It can be null.</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.xendbridge.com/api-method-calls/webhooks/order-matched-notification.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.