Skip to content

Payment Mappings

Use Payment Mappings to map the payment types of your marketplaces and shops to Business Central payment terms and payment methods. The mapping is applied during order import: it controls which payment terms and payment method the imported sales order receives, whether a fee line is created and — for PayPal pay upon invoice — which assignment notice is printed on the invoice.

Open the page

  • Via search: MC Payment Mappings
  • Via the Setup (Reference) → action Payment Mappings

Fields

Field Description
Marketplace Code The marketplace this mapping applies to. Leave blank for a default mapping that applies to all marketplaces. A marketplace-specific mapping takes precedence over the default.
Payment Type The payment type identifier supplied by the marketplace (e.g. paypal, prepayment, invoice). For the Shopware 6 connector this is the display name of the payment method. Matching is case-insensitive.
Payment Terms Code The Business Central payment terms assigned to the sales order for this payment type.
Payment Method Code The Business Central payment method assigned to the sales order.
Charge Item No. The item charge used for fee lines (e.g. PayPal fees). Leave blank if no fee line should be created.
Paid When Status Optional condition: the payment terms are only applied when the order payment status matches this value (e.g. completely_paid).
Assignment Notice A legal notice copied to the sales order on import and printed on the invoice when the receivable is assigned to a payment provider (factoring) — see PayPal pay upon invoice.

PayPal pay upon invoice

With PayPal pay upon invoice (handled via Ratepay) the customer does not pay you as the merchant, but a PayPal/Ratepay bank account with a fixed payment reference and its own due date. To keep the invoice correct, merchantCENTRAL copies the payment instructions (account holder, bank, IBAN, BIC, payment reference, due date) from the shop to the sales order during import.

Setup

  1. Create payment terms that match the PayPal payment term (typically 30 days net, e.g. code PAYPALRK).

  2. Create a payment mapping row:

    Field Recommendation
    Payment Type Display name of the pay-upon-invoice method from the shop, e.g. PayPal Rechnungskauf
    Payment Terms Code PAYPALRK
    Payment Method Code e.g. PAYPAL
    Assignment Notice e.g. "The receivable from this invoice has been assigned to PayPal (Europe) S.à r.l. et Cie, S.C.A. Payment with debt-discharging effect can only be made to the account stated above."

Flow

  • During order import the payment instructions are written to the sales order (group Payment Instructions on the order card, only shown when instructions are present). The order's due date is taken from the instruction.
  • During posting the instructions are transferred to the posted sales invoice.
  • On the invoice printout (report Standard Sales - Invoice) the bank details, payment reference, due date and assignment notice are printed.

Fetch instructions later (Shopware 6)

PayPal only provides the bank details a few minutes after checkout. If an order was imported before the instructions were available, you can fetch them from the sales order card via the Get PayPal Payment Instructions action — before posting the invoice.