External payment methods

An external payment method is a method Kustom doesn’t process, shown in the checkout’s payment list next to the ones it does. Selecting it sends the customer to a page you host, along with the rest of the purchase.

PayPal has a page of its own: Kustom presents it and manages the order, and PayPal pays out and handles disputes.

Adding an external payment method

An external payment method appears in the checkout’s payment list. The customer enters their address details in Kustom Checkout as usual, but selecting the method redirects them to a URL you provide, and from there the purchase is entirely yours.

{
  "external_payment_methods": [
    {
      "name": "Cash on delivery",
      "redirect_url": "https://shop.example/pay/cash-on-delivery",
      "image_url": "https://shop.example/img/cod.png",
      "fee": 1450,
      "description": "Pay the driver when your order arrives. [How it works](https://shop.example/help/cod)"
    }
  ]
}

Field	Required	Notes
name	Yes	Must match a supported name below. Case is ignored. Up to 255 characters
redirect_url	Yes	HTTPS. The page where the customer completes the purchase
image_url	No	HTTPS. Exactly 69 by 24 pixels
fee	No	Added to the order, in minor units. Includes tax
description	No	Up to 500 characters. Markdown links are allowed. Shown under the method once it is selected
countries	No	Alpha-2 codes. Limits the method to the markets listed
label	No	continue or complete — the wording on the buy button

countries is the one worth knowing about: Kustom drops any method whose list doesn’t contain the customer’s billing country — the purchase country until an address is entered — so a single payload can carry every external method you offer and each customer sees only the ones that work where they are. Leave it out and the method shows everywhere. label takes continue or complete and nothing else — any other value fails the call with BAD_VALUE.

What you take on when you go external

These warnings are the reason an external method is a deliberate choice rather than a configuration flag.

• Kustom creates no order and tracks nothing. There’s no order in Order Management to capture, refund or reconcile against.
• No customer data crosses over. Kustom shares nothing with the external provider. You or the provider must collect, secure and store whatever the purchase needs — address, name, contact details.
• Every page after the redirect is yours. Order summary, confirmation, receipts, reconciliation.
• You need a backend integration with the provider. Selecting the method in Kustom only redirects. Nothing is paid or authorized by that click.
• Kustom’s buyer protection doesn’t apply. Label these methods clearly as external so customers aren’t misled about what protects the purchase.
• A contractual agreement is required with the external provider, for compliance reasons. Contact your account manager before enabling one.

Supported external payment method names

Matching ignores case, but otherwise a name must be spelled exactly as listed, spaces and punctuation included. A name that isn’t on the list is not an error: the method is silently left out of the checkout. The same goes for every external method until external payment methods are enabled for your account.

Name	Primarily used in
Achteraf betalen	NL
Alipay	Global
Amazon	Global
Amazon Pay	Global
Amazon Payments	—
Amex	Global
Apple Pay	Global
Bancontact	BE, NL
Bank Transfer	Global
Bankoverførsel	DK
Banköverföring	—
Barzahlen	DE, AT
Barzahlung Bei Abholung	—
Bedriftsfaktura	NO
Betal i butikk	—
Betal på verkstedet	—
Betala i butik	SE
Betala på plats	—
Betala på station	—
Betalning på betjäningsstället	—
bitcoin	Global
BLIK	—
BLK	—
Bonifico Bancario	IT
Business Invoice	—
Bussiennakko	FI
Card	—
Carte Bancaires	FR
Carte Bleue	FR
Cash on Delivery	Global
Cash on Hand	Global
ClickandBuy	DE, AT
CoinPayments	Global
Consors Finanz	DE
Coop Inköpstjänsten	—
Coop Matkonto	—
Coop på faktura	—
Dankort	DK
Delbetal i ditt eget tempo	NO
Delbetalning	SE
Diners/Discover	—
Divide.Connect	—
EAN Fakturering	DK
Easy Dibs	SE
Ennakkomaksu	FI
EU- standaard bankoverschrijving	NL
EU-Standard Bank Transfer	—
Faktura	SE
Faktura 14 dagar	SE
Faktura 14 dage	DK
Fast delbetaling	SE
Forskudd	NO
Företagsfaktura	SE
Förskottsbetalning	SE
Gavekort	NO
Giropay	DE, AT
Google Pay	—
Google Wallet	Global
iDEAL	NL
Konto	—
Kort	—
Kortti	FI
Kreditkarte	DE, AT
Lasku	FI
Lasku 14 päivää	FI
Lastschrift	DE, AT
M-Cash	—
Maksu liikkeessä	FI
Maksu noudon yhteydessä	FI
Maksu palvelupisteellä	FI
MobilePay	—
Multibanco	—
Nachnahme	DE, AT
OnPay	—
Pagamento Alla Consegna	IT
Partner	—
Pay at office	FI
Pay at station	—
Pay in-store	—
Paydirekt	DE, AT
PayPal	Global
PayPal Pay Later	—
Postförskott	SE
Postiennakko	FI
Postoppkrav	NO
Sagepay	—
Samlingsfaktura	—
Samsung Pay	—
Santander	—
Slice it	—
SOFORT Überweisung	—
Sparxpres	—
Sparxpress	—
Strix	—
Swish	—
Transferencia Bancaria	Global
Tuotevakuudellinen rahoitus	—
Verkkolasku	—
Verkkomaksu	FI
Vipps	NO
Virement bancaire	FR
Vorkasse	DE, AT
Vorkasse Banküberweisung	DE, CH
Wire Transfer	Global
Zahlung bei Abholung	DE, AT
Zaver	—
Zaver_pay_in_parts	—
Zaver_pay_later	—
銀行振込	JP

Related

• Create an order — where external_payment_methods goes on the request.
• PayPal — the method Kustom presents but does not settle.
• Order Management — understand what you give up when a purchase leaves Kustom.
• Checkout API reference — the full field definitions.