---
title: "POST /send_notification"
method: POST
path: "/send_notification"
tags: ["Notifications"]
---

# POST /send_notification

`POST /send_notification`

Create and send an order confirmation, payment confirmation, or Disbursement User Query email or SMS message to the consumer.

## Request body

- union — Creates and sends an Email or SMS message about the order, payment, or disbursement
  - object
    - `site_identifier` string, required — Identifies your client site.
    - `timestamp` string, required — The Unix Epoch time of the call
    - `version` string, required — The version of the API. This version must match the version associated with your API key pair.
    - `signature` string, required — The HMAC signature that is calculated by running your API Secret Key and the alphabetized, concatenated parameters of the request payload through the SHA256 message digest algorithm.
    - `site_customer_email` string — The email addresses where you are sending the email. Use commas to separate email addresses when sending the message to multiple recipients.
    - `site_customer_phone` string — The text of the SMS message. This parameter does not support HTML or special characters like emojis.
    - `order_confirmation` string — Submit as <code>true</code> to send the consumer the order confirmation email or SMS message.
    - `paid_confirmation` string — Submit as <code>true</code> to send the consumer the payment confirmation email or SMS message. This call will only work for orders that have been paid.
    - `user_disbursement_query` string — Submit as <code>true</code> to send the consumer the disbursement user query email or SMS message. This message instructs disbursement recipients on how to input their debit card, bank account, or mobile wallet information where they'll receive their funds.
    - `pnm_order_identifier` string, required — The unique, PayNearMe-defined identifier for this order
  - object
    - `site_identifier` string, required — Identifies your client site.
    - `timestamp` string, required — The Unix Epoch time of the call
    - `version` string, required — The version of the API. This version must match the version associated with your API key pair.
    - `signature` string, required — The HMAC signature that is calculated by running your API Secret Key and the alphabetized, concatenated parameters of the request payload through the SHA256 message digest algorithm.
    - `site_customer_email` string — The email addresses where you are sending the email. Use commas to separate email addresses when sending the message to multiple recipients.
    - `site_customer_phone` string — The text of the SMS message. This parameter does not support HTML or special characters like emojis.
    - `order_confirmation` string — Submit as <code>true</code> to send the consumer the order confirmation email or SMS message.
    - `paid_confirmation` string — Submit as <code>true</code> to send the consumer the payment confirmation email or SMS message. This call will only work for orders that have been paid.
    - `user_disbursement_query` string — Submit as <code>true</code> to send the consumer the disbursement user query email or SMS message. This message instructs disbursement recipients on how to input their debit card, bank account, or mobile wallet information where they'll receive their funds.
    - `site_order_identifier` string, required — An arbitrary string that the client uses to refer to an order

## Response `201`

Message Sent

- SendNotificationResponse
  - `status` string — Provides the status of the request.
  - `disbursement_query_url` string — Provides the URL where the consumer can add his/her debit card, bank acount, or mobile wallet information where he/she wants to receive the disbursement funds.
  - `disbursement_status` 'queried_user' | 'created' | 'complete' — Indicates the status fo the disbursement.

---

[API](https://skmtc.net/paynearme/apis/paynearme-api-v3-0.md) · [All operations](https://skmtc.net/paynearme/apis/paynearme-api-v3-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paynearme/paynearme-api-v3-0/versions/44cba4f8b80f/schema)