Pay by Link Payment Method Mapping

Payment Method Mapping Functionality Overview
This functionality enables the mapping of external payment method data to internal codes used within Business Central for payment processing.

Key Definitions:

  • External Payment Method Code: This refers to the payment method identifier from an external system, such as a Magento website (e.g., adyen_amazonpay, adyen_cc, adyen_cc_paid).
  • External Payment Type: This indicates the type of payment as defined by the payment service provider (PSP), such as mc for Mastercard, visa for Visa, etc.

Using a combination of the External Payment Method Code and the External Payment Type, the system identifies the appropriate Payment Gateway Code and Payment Method Code in Business Central to process the payment.

Special Case: Pay by Link
For Pay by Link transactions, the setup differs slightly:

  • External Payment Method Code: This will be left empty because the customer is not selecting a payment method from an external website. Instead, the payment link is generated directly
  • External Payment Type: When the customer completes the payment, Adyen will return the card type used (e.g., Visa, Mastercard). We configure separate records in the Payment Method Mapping for each expected card type.

Business Central uses the combination of the (empty) External Payment Method Code and the provided External Payment Type to determine the correct Payment Method Code for posting the payment.

While the Payment Gateway Code field can be populated in the Payment Method Mapping, it is not utilized in the Pay by Link scenario. This is because the payment gateway is already known and fixed at the time the payment link is generated.

Fallback Behavior
If no matching record is found in the Payment Method Mapping, the system will default to retrieving the payment account from the NP Pay Setup, consistent with the current behavior.

← Set up NP Pay Cloud
Set up NP Retail Emergency mPOS →