Skip to main content
Beta version

Welcome to the beta version of the Global Payments 2 API! For the generally available Global Payments API, refer to Global Payments

Resources

Back-dated and future-dated transactions

Push to Wallet supports back-dated and future-dated transactions. Future-dated transactions are marked as SCHEDULED until the requested execution date and then released for continued processing.  

The following table contains the supported past and future execution date ranges for Push to Wallet:

Past and future date ranges for Push to Wallet

Region

Country

Past date range

Future date range

North America (NA)

United States

One calendar day

Five calendar days

Currency codes

A currency code identifies a payment’s currency.

The following table contains the supported currency code for Push to Wallet:

Currency codes for Push to Wallet

Region

Country

Currency code

 NA

United States

USD

Duplicate logic

A Push to Wallet payment is irrevocable. Before you attempt to send the same payment more than once, you must confirm that the initial payment was rejected. To confirm the status of any payment, get the status of a Push to Wallet payment.

Duplicate transactions

The Global Payments API supports the ability for idempotent calls, which is useful when you initiate a payment, create a client, make a change, or retry a failed request for some reason, such as a network issue.

If a Push to Wallet payment has the same debtor.account.accountNumber and paymentIdentifiers.endToEndId as another Push to Wallet payment within the last 30 days, the Global Payments API deems it duplicative and rejects it. The sender is then notified of the rejection and the funds remain in the sender's account.

Payment options

A Push to Wallet payment can be sent to a beneficiary’s PayPal or Venmo wallet through the beneficiary’s associated email address or mobile phone number.

The following table provides more information about each of these options:

Payment options for Push to Wallet
Payment option Notes
  • Email address
  • Mobile phone number
Must be registered with PayPal or Venmo before payments can be disbursed.

Purpose codes

A purpose code identifies a payment's purpose.

The following table contains the supported purpose codes for Push to Wallet:

Purpose codes for Push to Wallet
Region Country Purpose code Description
NA United States AWARDS Awards payouts.
CASHBACK Cashback payouts.
DISCOUNTS Discount payouts.
DONATIONS Donation payouts.
GOODS Payouts for goods sold.
NON-GOODS OR SERVICES Payouts for any non-goods or services.
PRIZES Prizes payouts.
REBATES Rebate payouts.
SERVICES Payouts for services provided.

Sanctions screening

J.P. Morgan screens client payment information to comply with United States Office of Foreign Assets Control (OFAC) regulations, applicable non-United States sanctions, and national and international anti-terrorism laws.

Status responses

A status response identifies a payment’s status. A status response includes one or more sub-status responses that provide more information about a payment's status.

The following table provides the statuses, sub-statuses, and their descriptions for Push to Wallet:

Status responses for Push to Wallet

Status

Sub-status

Description

Processing

Processing by J.P. Morgan

The payment is being processed by J.P. Morgan.

Scheduled The payment is scheduled for future execution.
Sent to 'External'

The payment was sent to an external party, such as a clearinghouse or beneficiary bank.

Rejected

Rejected

The payment was rejected by J.P. Morgan.

Completed

Completed by J.P. Morgan

The payment was fully processed by J.P. Morgan. It's no longer under the control of J.P. Morgan.

Returned

Returned

The payment was returned by an external party, such as a clearinghouse or beneficiary bank.

Value-amount limits

A value-amount limit identifies the maximum amount of money permitted in a payment.

The following table contains the supported value-amount limits for Push to Wallet:

Value-amount limits for Push to Wallet

Region

Country

Value-amount limit

NA

United States

60000

  • For more information about Push to Wallet, see Overview.
  • For more about Push to Wallet payment parameters, see Payment parameters.

Next steps

Learn how to initiate a Push to Wallet payment.