/change_order

post

https://api.paynearme-sandbox.com/json-api/change_order

Gives you the ability to change an order’s specific parameters. These can include the following (see the Orders object for specific name values):

Minimum Amount
Order Amount
Order Duration and Expiration Date
Customer Attributes like name, address, and contact information
Order Description and Annotation
Suspension Status and Reason
Autopay Attributes like status, frequency, amount, payment method, and start/end dates

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

📘
Best Practices to Ensure Fast API Response Times
By default, PayNearMe will return all payments related to an order in response to your API call. This results in lengthy responses as your orders accrue payments in our system. The following options reduce load times and bandwidth usage, helping to lower network costs.
Limiting Payment Listings
For the fastest responses, sending return_minimal_info=true ensures that PayNearMe will only return the pnm_order_identifier and the pnm_customer_identifier.
If you require more information in the response than that, but do not require payment history, sending return_no_pmts=true in your request will eliminate payment history entirely.
If you prefer to receive just the most recent payment, sending last_pmt_only=true in your request will limit the response to just the most recent payment.
Limiting Payment Method Listings
Use payment_methods_limit to limit the number of stored payment methods (accounts) returned within each payment method type (i.e., paypal, venmo, debit, gpay, ach, cash_app) in the response. This is useful for orders with many saved payment methods where returning all accounts would impact performance.

🚧
Autopay Schedule Updates
PayNearMe is aligning scheduled ACH processing with common industry practice for bank-to-bank settlement. This timing applies to recurring and one-time, future-dated ACH payments.
What Stays the Same?
The consumer’s bank account is still debited on the scheduled transaction date.
What Changes?
Payment instructions may reach the banking network one banking day earlier. The consumer’s bank does not process or post the debit until the scheduled date.
Skip, Cancel, and Schedule Updates
Because of the earlier handoff, skip and cancel are not available on or after the prior banking day before the scheduled date. Any updates to the schedule (including skip or cancel) must be completed at least two banking days before the scheduled transaction date. Weekends and bank holidays do not count as banking days, so the required lead time may be longer in calendar days.

Body Params

pnm_order_identifier

string

required

The unique, PayNearMe-defined identifier for this order

site_identifier

string

required

Defaults to S2411573363

Identifies your client site.

timestamp

string

required

The Unix Epoch time of the call

version

string

required

Defaults to 3.0

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.

order_amount

string

Defaults to 250

The decimal amount of the order.

order_currency

string

Defaults to USD

USD

site_customer_identifier

string

A unique, client-created string that identifies the customer.

order_type

string

enum

Defaults to any

The type of order. Supported values include the following:

exact = Consumer must pay the exact order amount.
up-to = Consumer any amount up to the order amount.
any = Consumer can pay any amount.

Allowed:

order_is_standing

string

Defaults to true

If the order can be repeatedly paid for, enter true.

minimum_payment_amount

number

The minimum payment amount in US Dollars including the decimal point.

minimum_payment_currency

string

USD

order_duration

string

The number of days from order creation that payments can be accepted. If omitted, payments can be accepted for the order forever.

order_expiration_date

string

The date and time when the order will expire. This value must be in the following 24-hour format YYYY-MM-DD HH:MM:SS TZ where TZ is ET, CT, MT, or PT.

return_minimal_info

string

If set to true, PayNearMe will only return the pnm_order_identifier and pnm_customer_identifier.

return_html_slip

string

Setting this to true causes the HTML version of the payment slip (for cash payments) to be returned in the element of the slip portion of the XML. It is in a CDATA block. This HTML can be inserted in a page on your site to create a seamless user experience. Note that it is not a complete HTML page but contains a few elements.

return_pdf_slip

string

Setting this to true causes the pdf version of the entire slip to be returned in the element of the slip portion of the XML. It is in a CDATA block. This PDF can be printed or merged with other PDF files as needed.

payment_start_date

string

Enter a date in YYYY-MM-DD format to filter the list of payments that are returned in the order object response. For example, entering 2012-07-01 returns all payments that occurred on or after 2012-07-01 00:00:00 -0700.

payment_end_date

string

payment_count_limit

string

Enforces a limit to the number of payments that are returned in the order object response. For example, entering 2 limits the number of payments listed in the order to the 2 most recent payments. Use this parameter in conjunction with the sort_payments parameter to sort the listed payments by oldest (i.e.,asc) or the most recent (i.e., desc). By default, all payments are returned, which can slow down response time.

payment_methods_limit

integer

Maximum number of payment processor accounts (PPAs) to return per payment method. Use 0 for no PPAs. Default: unlimited.

sort_payments

string

enum

Sorts the payments returned in the order object response from oldest to most recent (i.e., asc) or from the most recent payments to oldest (i.e., desc). The default value for this parameter is asc.

Allowed:

last_pmt_only

string

Submit as true to only return the most recent payment made for the order in the order object response.

return_no_pmts

string

If set to true, PayNearMe will not return any payments made towards the balance of the order.

settlement_friendly_name

string

The nickname of the client bank account where transaction settlements occur.

site_creator_identifier

string

A unique string used to identify the creator of the order. This parameter can be used to find orders in the /find_orders call.

site_order_identifier

string

An arbitrary, client-defined string used to refer to this order.

site_order_description

string

The client's description of the order. This does not appear on the payment slip (for cash payments) but is useful for support issues.

site_order_annotation

string

Use this parameter to pass back additional information about the order. The values passed in this field are available in receipt text, macros, and the confirmation verbiage that displays in approve response.

site_order_suspend

string

Set to true to suspend the order so no further payments can be accepted.

site_order_suspend_reason

string

A brief description of why the order was suspended.

site_customer_sms_ok

string

Use true to indicate that the consumer has granted permission to receive text messages regarding his or her account.

site_customer_phone

string

The consumer’s mobile phone number.

site_customer_email

string

The consumer's email address.

site_customer_name

string

The first and last name of the consumer. You can also send the consumer’s first and last names in separate parameters using site_customer_first_name and site_customer_last_name.

site_customer_year_of_birth

string

The consumer's four-digit year of birth (i.e., YYYY)

site_customer_language

string

enum

Specifies whether the consumer’s preferred language is

en = English
sp = Spanish

Allowed:

site_customer_first_name

string

The consumer's first name.

site_customer_last_name

string

The consumer's last name.

site_customer_street

string

The consumer’s street address from his/her billing address.

site_customer_city

string

The consumer's city from his/her billing address.

site_customer_state

string

The consumer’s two-character state abbreviation from his/her billing address (e.g., TX, AK, NY, etc).

site_customer_postal_code

string

The consumer’s ZIP code from his/her billing address.

order_reminder_amount

string

The order amount to include in any Autopay scheduling reminders.

order_reminder_payoff_amount

string

The remaining balance of the order amount to include in any Autopay scheduling reminders.

order_reminder_status

string

enum

The status of the order reminder notification for any Autopay scheduling reminders. Supported values include the following:

active
user_suspended

Allowed:

order_reminder_frequency

string

enum

This parameter is used when setting up Autopay reminder emails and/or texts. The frequency of the reminder email/text. Supported values include the following:

weekly
biweekly
monthly
twice_monthly
end_of_month

Allowed:

order_reminder_start_date

string

This parameter is used when setting up Autopay reminder emails and/or texts. The date when Autopay reminders should begin in MM/DD/YYYY format.

order_reminder_end_date

string

This parameter is used when setting up Autopay reminder emails and/or texts. The date when Autopay reminders should end in MM/DD/YYYY format.

auto_pay_amount

number

The amount for each scheduled autopay payment without convenience fees.

auto_pay_currency

string

enum

USD

Allowed:

auto_pay_payment_method_identifier

string

The unique identifier for the payment method used for this autopay schedule.

auto_pay_status

string

enum

The status of the autopay schedule. Supported options include the following:

active
user_suspended

Allowed:

auto_pay_frequency

string

enum

The frequency of the autopay. Supported options include the following:

weekly
biweekly
monthly
twice_monthly
end_of_month

Allowed:

auto_pay_start_date

string

The start date of the autopay schedule in MM/DD/YYYY format.

auto_pay_end_date

string

The end date of the autopay schedule in MM/DD/YYYY format.

pricing_schedule_name

string

Specifies the name of the pricing schedule (e.g.,agent, agent_recurring, consumer, consumer_recurring,consumer_ivr). Supported values can include site-configured pricing schedules.

settlement_method_identifier

string

The ID of the bank account where any payments towards this order will be settled.

payment_types

string

enum

A listing of payment method types that this order will accept. Supported values include the following:

any
ach
credit
debit
paypal
venmo

Allowed:

Responses

Best Practices to Ensure Fast API Response Times

Limiting Payment Listings

Limiting Payment Method Listings

Autopay Schedule Updates

What Stays the Same?

What Changes?

Skip, Cancel, and Schedule Updates

201Order Updated

400Order Failed to Update