Skip to main content

Create a new payment method

Goal​

To set up and manage payment methods in the Propeller backoffice, enabling various payment options for customers during checkout. This includes configuring payment method names, external codes, and visual branding.

Step 1: Navigate to Payment Methods​

  1. From the backoffice menu, select Shops & Channels and then Payment Methods.
  2. You'll see a list of existing payment methods displaying:
    • Logo preview
    • Name
    • ID
    • Date Created
    • Date Updated
    • External Code

Step 2: Create a New Payment Method​

  1. Click the New Payment Method button in the top right corner.
  2. A popup window titled New Payment Method will appear.

Step 3: Configure Payment Method Details​

Complete the following fields in the popup:

Logo Configuration​

  • Logo url: Enter the URL for the payment method's logo image
    • Supports common image formats (PNG, JPG, SVG)
    • Logo will be displayed during checkout
    • Example: https://frameusercontent.com/images/oShRiODJ9JRMhkDB6tg7dmrMLRM.svg
  • If no logo URL is provided, click Add logo url to add one later

Required Information​

  • External Code: Enter a unique code that identifies this payment method

    • Must match the code used by your payment service provider
    • Examples: IDEAL, CREDITCARD, PAYPAL, AFHALEN
    • This code is used for integration mapping

  • Name (NL): Enter the display name for the payment method

    • This appears to customers during checkout
    • Enter in the appropriate language (NL dropdown allows language selection)
    • Examples: "Ideal", "PayPal", "Mastercard", "On account"

Step 4: Save the Payment Method​

  1. Click Save to create the payment method.
  2. The popup will close and the new payment method will appear in the list.
  3. Click Cancel to discard changes and close the popup.

Editing Existing Payment Methods​

  1. Click on any payment method in the list to edit it.
  2. The Edit Payment Method popup will open showing:
    • Current logo preview (if set)
    • Logo URL field
    • External Code
    • Name with language selector
    • Created and Last modified dates (read-only)
  3. Make necessary changes and click Save.

Best Practices​

  • Consistent External Codes: Use standardized codes that match your payment gateway configuration
  • Integration: Payment methods appear in checkout based on front-end logic
  • Clear Naming: Use names customers will recognize in their language
  • High-Quality Logos: Use clear, recognizable logos at appropriate resolution
  • Regular Reviews: Periodically check that all payment methods are still active and properly configured
  • Test Integration: Verify external codes work correctly with your payment processor
  • Language Support: Configure names for all languages your store support

Integration Considerations​

The external code is crucial for integration:

  • Must exactly match the code expected by your payment service provider
  • Case-sensitive in most systems
  • Used to map between Propeller and external payment systems
  • Cannot be changed after orders have been placed with this method