Important: The Adaptive Platform API is not available for
new integrations. PayPal provides this documentation to support existing
integrations. If you're starting an integration,
we recommend our latest solutions.
Sends a reminder that a payment is due. This API is useful when a customer
needs to be notified that an existing invoice needs to be paid.
Example
This example calls RemindInvoice to send a reminder to a
customer. The merchant intends to send the reminder for an existing invoice.
The existing invoice already has been sent to the customer, but the customer
hasn't paid the invoice yet:
The RemindInvoiceRequest is used to inform a customer about an
unpaid invoice. A merchant who uses the RemindInvoice API intends to send the
reminder for an existing invoice. The existing invoice already has been sent
to the customer, but the customer hasn't paid the invoice yet. The reminder
can be sent to the customer as often as desired.
RequestEnvelope Fields
Field
Description
detailLevel
common:DetailLevelCode(Optional) Level of detail
required by the client application pertaining to a particular data
component. The detail level is specified as a detail level code, which
has all the enumerated values of the detail level for the component. By
default, the detail level code is ReturnAll, which provides
the maximum level of detail.
errorLanguage
xs:string(Required) RFC 3066 language in which
error messages are returned; by default it is en_US, which
is the only language currently supported.
RemindInvoiceRequest Fields
Field
Description
requestEnvelope
common:requestEnvelope(Required) Information
common to each API operation, such as the language in which an error
message is returned.
invoiceID
xs:string(Required) The ID of the invoice for
which a reminder is sent.
subject
xs:string(Optional) The subject of the reminder.
noteForPayer
xs:string(Optional) Note to be included with the
reminder.
RemindInvoiceResponse Message
The response contains the ID of the invoice, along with the location for
viewing the invoice.
ResponseEnvelope Fields
Field
Description
ack
common:AckCode Acknowledgment code. Value is:
Success — The operation completed successfully.
Failure — The operation failed.
SuccessWithWarning — The operation completed
successfully; however, there is a warning message.
FailureWithWarning — The operation failed with a
warning message.
build
xs:string Build number. It is used only by PayPal Merchant
Technical Support.
correlationId
xs:string Correlation identifier. It is a 13-character,
alphanumeric string (for example, db87c705a910e) that is
used only by PayPal Merchant Technical Support.
Note: You must log and store this data for every
response you receive. PayPal Technical Support uses the information to
assist with reported issues.
timestamp
xs:datetime Date on which the response was sent, for
example: 2012-04-02T22:33:35.774-07:00
Note: You must log and store this data for every
response you receive. PayPal Technical Support uses the information to
assist with reported issues.
RemindInvoiceResponse Fields
Field
Description
responseEnvelope
common:ResponseEnvelope Common response information,
including a timestamp and the response acknowledgment status.
invoiceID
xs:string The ID of the invoice for which a reminder is
sent.
invoiceURL
xs:string The location for viewing the invoice.
PPFault Message
The PPFaultMessage returns ErrorData and the
ResponseEnvelope information to your application if an error
occurs.
FaultMessage Fields
Field
Description
error
common:ErrorData Detailed error information.
responseEnvelope
common:ResponseEnvelope Common response information,
including a timestamp and the response acknowledgment status.
ErrorData Fields
Field
Description
category
common:ErrorCategory The location where the error occurred.
Value is:
System — The system encountered errors; try again
Application — The application encountered errors; try
again
Request — The request was incorrect
domain
xs:string The domain to which this service belongs.
errorId
xs:long A 6-digit number that uniquely identifies a
particular error.
exceptionID
This field is not used.
message
xs:string A description of the error.
parameter
common:ErrorParameter Represents contextual information
about the error.
severity
common:ErrorSeverity The severity of the error encountered.
Value is:
Error — Processing of the request was interrupted
Warning — Processing of the request was completed
subdomain
This field is not used.
RemindInvoice API Errors
Code
Message
520002
Internal error.
520003
Authentication failed. API credentials are incorrect.
520009
Account is restricted.
570054
Invalid token.
570058
Authentication failed. User account is not confirmed.
571001
The specified invoice ID is invalid because the invoice has already been
deleted.
571003
You can only send a reminder for an invoice with the status of sent. The
current status is draft.
571004
You can only send a reminder for an invoice with the status of sent. The
current status is paid.
571005
You can only send a reminder for an invoice with the status of sent. The
current status is refunded.
571006
You can only send a reminder for an invoice with the status of sent. The
current status is cancelled.
580045
Merchant does not have a PayPal account associated with this email
address.
580047
Invoice does not exist.
If you accept cookies, we’ll use them to improve and customize your experience and enable our partners to show you personalized PayPal ads when you visit other sites. Manage cookies and learn more