Security change on December 1, 2026: TLS 1.2 will become the minimum standard for 365 business Print Agent. Details and system requirements
365 business development
PayPal

Collect payments via PayPal

How to collect invoice amounts via PayPal in 365 business Banking: with the customer's stored payment method, individually or in batches.

Applies to: PayPal

The process is the same for all payment service providers with collection and is described in detail under Collect payment via payment service providers. This page describes the specifics of PayPal.

Prerequisites

  • The PayPal account is connected (Connect PayPal).
  • In addition to Transaction Search, your REST API app at PayPal has the Save payment methods permission (see below).
  • A payment method whose Bal. Account Type is Bank Account, pointing to the PayPal bank account, for example PAYPAL.
  • A customer bank account with Payment Service Type PayPal and a successful payment authorization.
  • A preferred bank account is not required. The customer's preferred bank account is collected from if its Payment Service Type is PayPal, otherwise the customer bank account with the Payment Service Type PayPal. See Which customer bank account is collected from.
  • For collection in the cash receipt journal, in addition: a journal batch collects through the PayPal bank account. The payment method has the Payment Method (Banking) Payment Service, which Business Central sets automatically if the field is empty. Existing payment methods with the type Direct Debit keep working. See Collection via a payment service provider.
App permissionDescription
Save payment methodsEnables storing payment methods so that customers can grant payment authorizations.

The Payment Methods list with ADYEN, PAYPAL and STRIPE, whose Bal. Account Type is Bank Account and whose Payment Method is Payment Service

Payment authorization

  1. Open the customer's Bank Accounts, create a customer bank account and set Payment Service Type to PayPal.
  2. Choose Request Payment Authorization. Business Central creates a payment authorization link at PayPal and opens the email editor with an email to your customer that contains this link.
  3. Using the link, the customer stores a payment method at PayPal. Business Central checks in the background whether the authorization has been granted and fills in the PayPal Vault Token ID; the Payment Authorization Status changes to Success. While the authorization is pending, you can query the status immediately with Check Payment Authorization Status. The PayPal Customer ID under which PayPal identifies the customer is also shown on the customer card on the Payments FastTab in the Payment Service group.

Example of an email with the PayPal payment authorization link

Customer bank account with Payment Service Type PayPal, the PayPal Vault Token ID and the payment authorization status

The pages your customer sees after the authorization are set in the PayPal Connection Setup with Success Redirect URL and Cancel Redirect URL; without them, the standard pages of 365 business Banking appear.

Note

The standard pages are static. So that your customer can see which company they authorized, Business Central passes the company name as a query parameter.

Standard page for successful authorization:

Standard page of 365 business Banking after a successful PayPal payment authorization

Standard page for cancelled authorization:

Standard page of 365 business Banking after a cancelled PayPal payment authorization

Collect payments

RouteProcedure
when postingpost a sales invoice with the PayPal payment method; if it is due, it is collected immediately and the invoice is applied. The payment gets the posting date of the invoice
individuallyon the Posted Sales Invoice, Collect Payment; before the due date with a question. Business Central reports the result
in batchesreport Collect Payments, also as a job queue entry
in the cash receipt journalSuggest Direct Debits and Carry Out Direct Debit in a journal batch that collects through the PayPal bank account; ask for the outcome of a pending collection with Check Status at Payment Service

Every attempt appears in the Payment Transaction Log, whichever way is used. As a result, no invoice is collected twice. The full remaining amount of the invoice is always collected, without payment discount. The rules for every way are described in Collect payments via payment service providers.

Payment Transaction Log card of a successful and posted collection via PayPal

Posted sales invoice with the Payment Transactions FactBox

The Collect Payments report request page with From Due Date, To Due Date, Post Collected Payments, Show Details and the customer filter

Troubleshooting

If collection fails, the invoice stays open. The Payment Transactions FactBox of the posted invoice shows the status of the attempt; the cause is shown in the Payment Transaction Log under Error Message. First check the payment authorization status and the payment method, and trigger the collection again only after the correction.

MessageCause and remedy
"PayPal is not set up for bank account …. Please complete the PayPal setup before capturing payments."There is no PayPal Connection Setup for the bank account, or it is not authenticated. Authenticate the connection. See Connect PayPal.
"Customer bank account … of customer … has no … payment method yet. Ask the customer to authorize the payment first."The PayPal Vault Token ID is missing on the customer bank account. Obtain the payment authorization.
"PayPal is not configured for bank account …. Please complete PayPal authentication first."When requesting the payment authorization, the PayPal Connection Setup is missing. See Connect PayPal.
"Failed to capture PayPal order …. Server response: …"PayPal rejected the collection. The reason is given in the server response.

See also

Last modified on