---
title: "POST /find_scheduled_payments"
method: POST
path: "/find_scheduled_payments"
tags: ["One-Time Schedules"]
---

# POST /find_scheduled_payments

`POST /find_scheduled_payments`

Use either the <code>pnm_order_identifier</code> or the <code>site_order_identifier</code> to find the next scheduled payment for an order. These payments can include recurring payments from an autopay schedule or a future-dated, one-time payment.

## Request body

- union — Finds the next future-dated, one-time payment or autopay payment that is scheduled to process.
  - 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.
    - `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_order_identifier` string, required — An arbitrary string that the client uses to refer to an order

## Response `201`

Finds the Next Scheduled Payment

- ScheduledPayment — The Scheduled Payments object contains the details of future-dated, one-time payments.
  - `pnm_scheduled_payment_identifier` string — The unique, PayNearMe-provided ID of this scheduled payment.
  - `scheduled_payment_date` string, date-time — The date and time when the consumer scheduled the payment.
  - `scheduled_payment_amount` number — The total amount of the scheduled payment including convenience fees.
  - `scheduled_payment_currency` string — USD
  - `scheduled_payment_status` 'active' | 'user_suspended' | 'pending' | 'complete' | 'disabled' — The status of the payment.
  - `scheduled_payment_pricing_schedule_name` string — Specifies the name of the pricing schedule (e.g.,<code>agent_recurring</code> or <code>consumer_recurring</code>). Supported values can include site-configured pricing schedules.
  - `scheduled_payment_payment_method` string — A short description of the payment method that will be used for this scheduled payment.
  - `scheduled_payment_service_fee` string — The service fee that will be charged for this scheduled payment.
  - `scheduled_payment_origin` 'consumer' | 'merchant' | 'import' | 'pnm' — The origin of the scheduled payment. Supported options include the folloing:<ul><li><code>consumer</code></li><li><code>merchant</code></li><li><code>import</code></li><li><code>pnm</code></li></ul>
  - `scheduled_payment_created_by` string — The name or ID of the creator of this scheduled payment.
  - `scheduled_payment_type` string — Indicates whether this is a <code>recurring</code> autopay payment or a <code>one-time</code> scheduled payment.
  - `scheduled_payment_retry_pending` string — Indicates whether or not there is a pending retry scheduled for this transaction.

---

[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/revisions/44cba4f8b80f/schema)