유럽 결제 수단 - Dodo Payments Documentation

카드 대신 은행이나 현지 결제 앱으로 결제하기를 선호하는 유럽 고객에게 다가가려면 iDEAL, Bancontact, EPS, Multibanco, BLIK, SEPA Direct Debit, Satispay를 지원하세요. 현지 결제 수단이 온라인 결제에서 가장 일반적인 방식인 시장에서는 해당 결제 수단을 제공하면 전환율을 높일 수 있습니다.

지역 유럽 결제 수단이 중요한 이유는?

Higher Conversion

iDEAL은 네덜란드에서 가장 많이 사용되는 온라인 결제 수단입니다. iDEAL이 없으면 다른 방식으로 결제하지 않으려는 네덜란드 고객을 잃게 됩니다.

Bank Authentication

은행 인증 방식의 경우 고객은 은행 앱이나 은행 웹사이트에서 결제를 승인합니다.

Real-Time Settlement

이 페이지의 대부분의 결제 수단은 checkout 중에 결제를 확인합니다. SEPA Direct Debit 및 Multibanco ATM 결제는 나중에 확인됩니다.

지원되는 결제 수단

각 결제 수단은 checkout의 통화 및 결제 유형이 해당 조건과 일치할 때만 제공됩니다:

결제 수단	국가	통화	구독
iDEAL	네덜란드	EUR	아니요
Bancontact	벨기에	EUR	아니요
EPS	오스트리아	EUR	아니요
Multibanco	포르투갈	EUR	아니요
BLIK	폴란드	PLN	아니요
SEPA Direct Debit	유로존	EUR	예
Satispay	유럽(이탈리아)	EUR	예

iDEAL (네덜란드)

iDEAL은 네덜란드에서 가장 많이 사용되는 온라인 결제 수단입니다. 네덜란드의 모든 주요 은행에 직접 연결되며, 고객은 자신의 은행을 통해 각 결제를 승인합니다.

작동 방식

고객이 iDEAL을 선택하고 은행을 고른 다음 해당 은행에서 인증합니다:

지원되는 은행

iDEAL은 다음을 포함한 네덜란드의 모든 주요 은행에서 작동합니다:

ABN AMRO
ASN Bank
Bunq
ING
Knab
Rabobank
RegioBank
Revolut
SNS
Triodos Bank
Van Lanschot

구성

iDEAL을 제공하려면 ideal을(를) allowed_payment_method_types에 포함하고 EUR로 청구하세요:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['ideal', 'credit', 'debit'],
  billing_currency: 'EUR',
  billing_address: {
    country: 'NL',
    zipcode: '1012JS'
  },
  return_url: 'https://example.com/success'
});

Bancontact (벨기에)

Bancontact는 벨기에의 국가 결제 시스템입니다. 거의 모든 벨기에 은행이 온라인 결제에 이를 사용합니다.

기능

벨기에 고객이 이미 보유한 Bancontact 직불카드로 작동
Bancontact 모바일 앱을 통한 결제 지원
checkout 중 결제 확인
고객의 추가 등록 불필요

구성

Bancontact를 제공하려면 bancontact_card을(를) 포함하고 EUR로 청구하세요:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['bancontact_card', 'credit', 'debit'],
  billing_currency: 'EUR',
  billing_address: {
    country: 'BE',
    zipcode: '1000'
  },
  return_url: 'https://example.com/success'
});

EPS (오스트리아)

EPS(Electronic Payment Standard)를 사용하면 오스트리아 고객이 자신의 은행에서 온라인 은행 이체로 결제할 수 있습니다.

기능

오스트리아 은행에 직접 연결
checkout 중 결제 확인
오스트리아 소비자 사이에서 높은 신뢰도 보유

지원되는 은행

EPS는 다음을 포함한 오스트리아의 주요 은행에서 작동합니다:

Erste Bank
Bank Austria
Raiffeisen
BAWAG
Volksbank

구성

EPS를 제공하려면 eps을(를) 포함하고 EUR로 청구하세요:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['eps', 'credit', 'debit'],
  billing_currency: 'EUR',
  billing_address: {
    country: 'AT',
    zipcode: '1010'
  },
  return_url: 'https://example.com/success'
});

Multibanco (포르투갈)

Multibanco는 포르투갈의 은행 간 네트워크입니다. 고객은 온라인으로 결제하거나 ATM에서 결제 참조 번호를 사용해 결제할 수 있습니다.

결제 옵션

고객은 다음 세 가지 방법으로 Multibanco 결제를 완료할 수 있습니다:

온라인 뱅킹: 고객의 인터넷 뱅킹을 통한 은행 이체.
ATM 결제: 고객이 결제 참조 번호를 받고 Multibanco ATM에서 결제.
모바일 뱅킹: 고객의 은행 앱에서 결제.

ATM 결제 작동 방식

ATM 결제의 경우 고객은 다음과 같은 결제 참조 번호를 받습니다:

Entity: 12345
Reference: 123 456 789
Amount: €50.00

고객은 이 참조 번호를 사용해 포르투갈의 모든 ATM 또는 온라인 뱅킹에서 결제합니다. 참조 번호에는 유효 시간이 있으며, 해당 시간은 참조 번호와 함께 고객에게 표시됩니다.

구성

Multibanco를 제공하려면 multibanco을(를) 포함하고 EUR로 청구하세요:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['multibanco', 'credit', 'debit'],
  billing_currency: 'EUR',
  billing_address: {
    country: 'PT',
    zipcode: '1000-001'
  },
  return_url: 'https://example.com/success'
});

고객이 참조 번호로 결제하면 Multibanco ATM 결제가 완료되며, 이는 checkout 후 상당한 시간이 지난 뒤일 수 있습니다. 결제 확인 시점을 파악하려면 webhooks를 사용하세요.

BLIK (폴란드)

BLIK은 폴란드에서 가장 인기 있는 모바일 결제 수단입니다. 고객은 은행 앱에서 생성한 일회성 6자리 코드로 결제합니다. BLIK 결제는 EUR이 아닌 PLN(폴란드 즐로티)으로 청구됩니다.

작동 방식

고객이 은행 앱에서 코드를 생성하고 checkout에 입력한 후 앱에서 결제를 승인합니다:

이용 가능 여부

청구 통화: PLN만 지원
거래 유형: 일회성 결제만 지원. BLIK은 구독에 제공되지 않습니다.
지원 범위: BLIK을 지원하는 폴란드의 모든 주요 은행

구성

BLIK을 제공하려면 blik을(를) 포함하고 billing_currency을(를) PLN(으)로 설정하세요:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['blik', 'credit', 'debit'],
  billing_currency: 'PLN',
  billing_address: {
    country: 'PL',
    zipcode: '00-001'
  },
  return_url: 'https://example.com/success'
});

BLIK에는 PLN 청구 통화가 필요하며, Dodo Payments는 Adaptive Currency가 활성화된 경우에만 PLN으로 청구합니다. Adaptive Currency를 활성화하면 폴란드 고객에게 PLN으로 청구되고 BLIK을 사용할 수 있습니다.

SEPA Direct Debit (유로존)

SEPA Direct Debit을 사용하면 유로존의 고객이 카드 대신 은행 계좌에서 결제할 수 있습니다. 청구 국가가 오스트리아, 벨기에, 에스토니아, 핀란드, 프랑스, 독일, 아일랜드, 이탈리아, 라트비아, 리투아니아, 네덜란드, 포르투갈, 슬로바키아 또는 스페인인 경우, EUR checkout에서 일회성 결제와 구독 모두에 제공됩니다.

SEPA Direct Debit은 즉시 처리되지 않습니다. 결제 확인까지 영업일 기준 최대 6일이 걸립니다. 카드 결제와 달리 checkout에서 고객이 승인했다고 해서 금액이 정산된 것은 아닙니다. checkout 리디렉션 또는 payment.processing에서 주문을 이행하지 마세요. payment.succeeded webhook을 기다리세요.

작동 방식

고객이 checkout에서 출금을 승인하면 Dodo Payments가 은행 계좌에서 금액을 수금합니다. 은행에서 비동기적으로 출금을 정산하므로 결제는 최종 결과에 도달할 때까지 processing 상태로 유지됩니다:

결제 일정

SEPA 결제는 다음 단계를 거칩니다:

단계	시점	결제 상태	의미
승인	checkout 시점	`processing`	고객이 출금을 승인하고 다시 리디렉션되었습니다. 아직 금액이 이동하지 않았으므로 주문을 이행하지 마세요.
확인	이후 영업일 기준 최대 6일	`succeeded`	은행에서 출금을 정산했습니다. 이제 주문을 이행하세요.
실패	이후 영업일 기준 최대 6일	`failed`	잔액 부족 등의 이유로 출금 금액을 수금하지 못했습니다. 주문을 이행하지 말고 고객에게 알리세요.

고객이 사이트를 떠난 후 며칠이 지나야 확인이 도착하므로 checkout 리디렉션이 아니라 webhook handler가 access를 부여해야 합니다. 확인 지연 처리를 참조하세요.

이용 가능 여부

청구 통화: EUR
거래 유형: 일회성 결제 및 구독

구성

SEPA Direct Debit을 제공하려면 sepa을(를) 포함하고 EUR로 청구하세요:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['sepa', 'credit', 'debit'],
  billing_currency: 'EUR',
  billing_address: {
    country: 'DE',
    zipcode: '10115'
  },
  return_url: 'https://example.com/success'
});

SEPA 테스트 IBAN

test mode에서 checkout에 다음 IBAN 중 하나를 입력하여 특정 결과를 강제로 생성할 수 있습니다:

테스트 IBAN	동작
`DE89370400440532013000`	결제가 성공합니다.
`DE08370400440532013003`	최소 3분 지연 후 결제가 성공합니다.
`DE62370400440532013001`	결제가 실패합니다.
`DE78370400440532013004`	최소 3분 지연 후 결제가 실패합니다.
`DE35370400440532013002`	결제가 성공한 후 즉시 dispute됩니다.
`DE65370400440002222227`	잔액 부족으로 결제가 실패합니다.
`DE18370400440000066666`	은행 계좌를 사용할 수 없어 결제 수단을 생성할 수 없습니다.

국가별 동작을 테스트하려면 다른 유로존 국가의 성공 IBAN을 사용하세요:

국가	성공 IBAN
오스트리아	`AT611904300234573201`
벨기에	`BE62510007547061`
에스토니아	`EE382200221020145685`
핀란드	`FI2112345600000785`
프랑스	`FR1420041010050500013M02606`
아일랜드	`IE29AIBK93115212345678`
룩셈부르크	`LU280019400644750000`

지연 테스트 IBAN을 사용하여 checkout 리디렉션이 아니라 webhook handler가 access를 부여하는지 확인하세요. SEPA 결제는 고객이 checkout을 떠난 후에도 한참 뒤에 확인됩니다.

확인 지연 처리

SEPA는 checkout 후 영업일 기준 최대 6일이 지나야 정산되므로 브라우저 리디렉션으로는 결제 정산 여부를 알 수 없습니다. 대신 webhook 이벤트를 기반으로 주문 이행을 처리하세요. type 이벤트를 활성화하고 각 단계를 처리하세요:

이벤트 유형	발생 시점	처리할 내용
`payment.processing`	고객이 checkout에서 출금을 승인하고 다시 리디렉션된 시점.	주문을 이행하지 마세요. 주문을 대기 중으로 표시하세요. 선택적으로 고객에게 결제가 처리 중이라고 알릴 수 있습니다.
`payment.succeeded`	최대 영업일 기준 6일 후 은행에서 출금을 정산한 시점.	주문을 이행하세요. access를 부여하고, 제품을 provision하며, 영수증을 보내세요.
`payment.failed`	출금 금액을 수금하지 못한 시점.	고객에게 알리고 재시도하도록 안내하세요. 주문을 이행하지 마세요.

checkout 리디렉션 또는 payment.processing가 아니라 webhook의 payment.succeeded에서 주문을 이행하세요. 리디렉션은 고객이 출금을 승인하는 즉시 발생하며, 금액이 정산되기 며칠 전입니다.

다음 Express handler는 이벤트를 처리하기 전에 client.webhooks.unwrap을(를) 사용해 각 이벤트의 signature를 확인합니다. endpoint 설정은 Webhooks 가이드를 참조하세요. 모든 이벤트는 Webhook Event 가이드를 참조하세요.

Handling SEPA payment events

import express from 'express';
import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env.DODO_PAYMENTS_API_KEY,
  webhookKey: process.env.DODO_PAYMENTS_WEBHOOK_KEY,
});
const app = express();

// markOrderPending, fulfillOrder, and markOrderFailed are your own order functions.
app.post('/webhooks/dodo', express.raw({ type: 'application/json' }), async (req, res) => {
  let event;
  try {
    // Checks the webhook-id, webhook-signature, and webhook-timestamp headers.
    event = client.webhooks.unwrap(req.body.toString(), { headers: req.headers });
  } catch {
    return res.status(400).send('Invalid signature');
  }

  switch (event.type) {
    case 'payment.processing': {
      // SEPA debit authorized but NOT settled. This can last up to 6 business days.
      // Record the order as pending; do not grant access yet.
      await markOrderPending(event.data.payment_id);
      break;
    }
    case 'payment.succeeded': {
      // The debit cleared, so it's safe to fulfill now.
      await fulfillOrder(event.data.payment_id);
      break;
    }
    case 'payment.failed': {
      // The debit could not be collected (for example, insufficient funds).
      await markOrderFailed(event.data.payment_id);
      // Notify the customer and prompt a retry.
      break;
    }
  }

  res.json({ received: true });
});

checkout에서 고객의 기대치를 설정하세요. 출금이 정산된 후에만 access가 부여되므로 SEPA 고객에게 주문이 처리 중이며 결제가 확인되면 알림을 보내겠다고 안내하세요. 그렇지 않으면 카드 결제처럼 즉시 access가 제공될 것으로 생각할 수 있습니다.

Satispay (유럽)

Satispay는 유럽의 모바일 결제 네트워크로, 이탈리아에 가장 많은 사용자가 있습니다. 고객은 카드 또는 은행 정보를 공유하지 않고 Satispay 앱에서 결제합니다. Satispay 결제는 EUR로 청구됩니다.

기능

카드 네트워크에 의존하지 않는 앱 기반 결제
이탈리아에서 높은 사용률과 다른 유럽 시장에서의 사용 증가
일회성 결제 및 구독 모두 지원

이용 가능 여부

청구 통화: EUR
거래 유형: 일회성 결제 및 구독
금액: 결제당 €0.50~€999,999.99

구성

Satispay를 제공하려면 satispay을(를) 포함하고 EUR로 청구하세요:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['satispay', 'credit', 'debit'],
  billing_currency: 'EUR',
  billing_address: {
    country: 'IT',
    zipcode: '00100'
  },
  return_url: 'https://example.com/success'
});

API method 유형

다음 값을 allowed_payment_method_types에 전달하세요:

유형	결제 수단	국가
`ideal`	iDEAL	네덜란드
`bancontact_card`	Bancontact	벨기에
`eps`	EPS	오스트리아
`multibanco`	Multibanco	포르투갈
`blik`	BLIK	폴란드
`sepa`	SEPA Direct Debit	유로존
`satispay`	Satispay	유럽(이탈리아)

여러 국가를 대상으로 하는 유럽 checkout

여러 유럽 국가에서 판매하려면 모든 지역 결제 수단과 fallback으로 카드를 포함하세요:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: [
    'ideal',           // Netherlands
    'bancontact_card', // Belgium
    'eps',             // Austria
    'multibanco',      // Portugal
    'blik',            // Poland (requires PLN billing currency)
    'sepa',            // Eurozone (one-time payments and subscriptions)
    'satispay',        // Europe / Italy
    'credit',          // Fallback
    'debit'            // Fallback
  ],
  billing_currency: 'EUR',
  return_url: 'https://example.com/success'
});

Dodo Payments는 각 고객에게 청구 국가 및 통화와 일치하는 결제 수단만 표시합니다. 네덜란드 고객에게는 iDEAL이 표시되고 벨기에 고객에게는 Bancontact가 표시됩니다. 이 session은 EUR로 청구되므로 BLIK은 표시되지 않습니다.

테스트

test mode에서 유럽 결제 수단을 테스트할 수 있습니다. 테스트 flow는 은행 인증 단계를 시뮬레이션합니다.

SEPA Direct Debit은 다른 테스트 flow를 사용합니다. 시뮬레이션된 은행 flow 대신 테스트 IBAN을 직접 입력합니다. SEPA 테스트 IBAN을 참조하세요.

Enable Test Mode

dashboard sidebar에서 Live Mode switch를 끄고 test mode에서 생성한 API keys를 사용하세요.

Set Appropriate Billing Address

결제 수단에 맞게 billing address country를 설정하세요:

NL(iDEAL)
BE(Bancontact)
AT(EPS)
PT(Multibanco)
PL(BLIK, PLN billing currency 사용)
IT(Satispay)

Complete the Test Flow

test mode에서 시뮬레이션된 은행 인증 flow를 따르세요.

모범 사례

Always include regional methods for target markets

네덜란드 고객에게 판매한다면 iDEAL을 포함하세요. iDEAL을 제외하는 것은 미국에서 Visa를 받지 않는 것과 같습니다. 상당한 매출을 잃게 됩니다.

Match currency to region

대부분의 유럽 결제 수단에는 EUR이 필요하므로 가격이 EUR 거래를 지원하는지 확인하세요. 예외는 BLIK으로, PLN(폴란드 즐로티) 청구에서만 제공됩니다.

Handle redirects gracefully

대부분의 유럽 결제 수단은 고객을 은행 또는 결제 앱으로 리디렉션합니다. flow 중간에 이탈하는 고객을 위해 return URL 처리가 작동하는지 확인하세요.

Provide card fallbacks

유럽의 모든 고객이 이러한 지역 결제 수단을 사용할 수 있는 것은 아닙니다. 예를 들어 관광객과 국외 거주자는 사용할 수 없을 수 있습니다. fallback으로 credit 및 debit을(를) 포함하세요. 사용할 수 있는 결제 수단이 없으면 checkout session이 실패합니다.

Consider Multibanco timing

Multibanco ATM 결제는 완료까지 몇 시간이 걸릴 수 있습니다. 즉시 결제를 전제로 주문 이행을 차단하지 마세요. 비동기 확인에는 webhooks를 사용하세요.

Account for the SEPA 6-day delay

SEPA Direct Debit은 확인까지 영업일 기준 최대 6일이 걸립니다. checkout 리디렉션 또는 payment.processing에서 주문을 이행하지 마세요. payment.succeeded webhook에서만 access를 부여하고 checkout에서 고객에게 주문이 pending 상태라고 안내하세요. 확인 지연 처리를 참조하세요.

문제 해결

European method not appearing

확인할 사항:

고객의 billing country가 결제 수단의 국가와 일치하나요?
billing currency가 EUR인가요, 아니면 BLIK의 경우 PLN인가요?
결제 수단이 allowed_payment_method_types에 포함되어 있나요?
checkout이 일회성 결제용인가요? iDEAL, Bancontact, EPS, Multibanco 및 BLIK은 구독에 제공되지 않습니다.

해결 방법: 국가별 결제 수단은 해당 국가에서만 표시됩니다. billing country가 DE(독일)인 고객에게는 네덜란드에서만 사용할 수 있는 iDEAL이 표시되지 않습니다.

Bank authentication failed

원인:

고객이 은행 인증 중 취소했습니다.
은행의 인증 시스템을 일시적으로 사용할 수 없었습니다.
고객이 잘못된 credentials를 입력했습니다.

해결 방법: 고객이 다시 시도해야 합니다. 실패가 계속되면 다른 결제 수단을 제안하세요.

Redirect not completing

원인:

고객이 은행 리디렉션 중 브라우저를 닫았습니다.
네트워크 문제로 인증이 중단되었습니다.
return URL이 잘못 구성되었습니다.

해결 방법: return URL이 올바르고 접근 가능한지, 성공 및 실패 상태를 모두 처리하는지 확인하세요.

Multibanco payment pending

원인: 고객이 결제 참조 번호를 받았지만 아직 결제하지 않았습니다.해결 방법: ATM 결제에서는 정상적인 상황입니다. webhook 확인을 기다리세요. 참조 번호는 고객에게 표시된 제한 시간이 지나면 만료됩니다.

SEPA payment stuck in processing

원인: SEPA Direct Debit은 고객의 은행을 통해 비동기적으로 정산됩니다.해결 방법: 정상적인 상황입니다. payment.processing 상태는 출금이 정산되기 전까지 영업일 기준 최대 6일 동안 지속될 수 있습니다. 최종 payment.succeeded webhook(주문 이행) 또는 payment.failed webhook(주문을 이행하지 않음)을 기다리세요. checkout 리디렉션을 확인으로 처리하지 마세요. 확인 지연 처리를 참조하세요.

Payment Methods Overview

지원되는 모든 결제 수단을 확인하세요.

Adaptive Currency

통화 지원 및 자동 conversion.

Checkout Guide

완전한 checkout 구현 가이드.

Webhooks

결제 확인을 비동기적으로 처리하세요.

​지역 유럽 결제 수단이 중요한 이유는?

Higher Conversion

Bank Authentication

Real-Time Settlement

​지원되는 결제 수단

​iDEAL (네덜란드)

​작동 방식

​지원되는 은행

​구성

​Bancontact (벨기에)

​기능

​구성

​EPS (오스트리아)

​기능

​지원되는 은행

​구성

​Multibanco (포르투갈)

​결제 옵션

​ATM 결제 작동 방식

​구성

​BLIK (폴란드)

​작동 방식

​이용 가능 여부

​구성

​SEPA Direct Debit (유로존)

​작동 방식

​결제 일정

​이용 가능 여부

​구성

​SEPA 테스트 IBAN

​확인 지연 처리

​Satispay (유럽)

​기능

​이용 가능 여부

​구성

​API method 유형

​여러 국가를 대상으로 하는 유럽 checkout

​테스트

​모범 사례

​문제 해결

​관련 페이지

Payment Methods Overview

Adaptive Currency

Checkout Guide

Webhooks

지역 유럽 결제 수단이 중요한 이유는?

지원되는 결제 수단

iDEAL (네덜란드)

작동 방식

지원되는 은행

구성

Bancontact (벨기에)

기능

구성

EPS (오스트리아)

기능

지원되는 은행

구성

Multibanco (포르투갈)

결제 옵션

ATM 결제 작동 방식

구성

BLIK (폴란드)

작동 방식

이용 가능 여부

구성

SEPA Direct Debit (유로존)

작동 방식

결제 일정

이용 가능 여부

구성

SEPA 테스트 IBAN

확인 지연 처리

Satispay (유럽)

기능

이용 가능 여부

구성

API method 유형

여러 국가를 대상으로 하는 유럽 checkout

테스트

모범 사례

문제 해결

관련 페이지