ZonePayments regularly retrieves new payment and refund activity from your payment provider. This information is recorded and centralized onto ZP Payment Provider Activity records, giving users visibility into the source and status of external payment activity as well as what NetSuite Transactions (e.g. Invoices, Credit Memos, Customer Deposits, and Refunds) have generated to record that activity.
Payment Provider Activity records are located under Transactions > Zone Payments > ZP Payment Provider Activity. Alternatively, these records may be accessed directly from the Invoice under the Related Records subtab.
This record will share the following information:
- Type of payment (payment, refund, or dispute)
- Origin of payment (NetSuite or payment provider)
- Error messages sent from the payment provider
- NetSuite Transactions (credit memo, invoice, or refund) related to the payment
- Autopay information
Payment Provider Activity Record Fields
Several fields on the Payment Provider Activity record are automatically set by your payment provider when a payment, refund, or dispute, is processed. It is advised that none of the information on this record is manually set by a user.
The following fields are set by automated ZonePayment system actions or your payment provider:
Transaction Activity Details
Type: Type of activity, either Payment, Refund, or Dispute
Payment Method: Payment Method used by the customer
Status: Transaction status provided by the payment provider. E.g. Succeeded, Pending, Failed, etc.
Payment Source: The feature used to create the transaction. E.g. Invoice Pay, Auto-pay, Provider Initiated Refund, etc.
Email Address: The email address submitted by the customer during payment.
Transaction Date: The date of the payment, refund, or dispute
Settlement Date: Date of the deposit transfer based on Payout. Generally, this is the arrival_date.
Currency: Currency of the payment, refund, or dispute.
Exchange Rate: Exchange Rate used by the payment provider.
Amount Authorized: The amount authorized by the customer’s card provider.
Amount Charged: The amount charged.
Payment Error: Any error that occurs during payment will display here.
ZPP Payment Provider: The payment provider that processed this payment type.
Provider Authorization Token:
Provider Charge Token: The provider charge token is a unique identifier that may be used to look up this charge through your payment provider account.
Provider Refund Token: The provider refund token is a unique identifier that may be used to look up this refund through your payment provider account.
Provider Dispute Token: The provider dispute token is a unique identifier that may be used to look up this dispute through your payment provider account.
Payment Intent ID: This ID references the original API request sent by your payment provider with the details for this Payment Provider Activity record.
NetSuite Customer: The NetSuite Customer associated with this payment, refund or dispute.
NetSuite Transactions: NetSuite Transactions created from this payment, refund or dispute.
NetSuite Payment(s): NetSuite Payment or Customer Deposit records created from this payment.
NetSuite Deposit: NetSuite Deposit record where funds deposited from this payment, refund or dispute are recorded.
Originating PPA: Originating Payment Provider Activity for any refunds/disputes.
ZP Customer Profile: ZonePayments Customer Profile related to this payment activity
Future Use Authorization
Authorizes Future Use Payment Token: This token is a unique identifier that may be used to look up the payment method that has been saved through your payment provider account for future payments.
Auto-Payment Authorized: The authorization language shared with the customer at the time of saving their payment for future use.
Payment Authorization: The ZP Payment Authorization record created to setup and manage future use of the payment method by this Payment Activity
Payment Provider Activity Subtabs
ZP Payment Application: This sublist shows how payment amounts are applied to specific Transactions. E.g. If a $1000 payment was made through Statement Pay for 3 different Invoices, three ZP Payment Applications, each representing an Invoice and its corresponding amount, would display here.
ZP Payment Provider Activity: This sublist shows any Payment Provider Activity records that are a refund or dispute of the original payment. E.g. If the original Payment Provider Activity record recorded a payment of $100 and two refunds of $50 were issued, two Payment Provider Activity records with a type of “refund” would display here.
ZP Payment Authorization: This sublist shows any ZP Payment Authorizations created and/or processed for this payment.