# 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>
