ACH Direct Debit

ACH Direct Debit을 사용하면 미국 고객이 카드 대신 bank account에서 결제할 수 있습니다. Automated Clearing House network를 통해 처리되며, 일회성 결제를 위한 USD checkout에서 제공됩니다.

ACH Direct Debit을 제공하는 이유

Lower Processing Cost

ACH 비용은 카드 수수료 대신 결제당 고정 1.5%이며, $15로 상한이 적용됩니다. pricing을 참조하세요.

No Card Required

bank account에서 결제하는 것을 선호하거나 고액 구매에 카드를 사용하고 싶지 않은 미국 고객에게 도달할 수 있습니다.

Higher Value Orders

수수료 상한이 $15이므로 주문 금액이 클수록 카드 수수료와 비교한 절감액이 커집니다. ACH는 대규모 일회성 구매에 적합합니다.

개요

Detail	Value
Billing Currency	USD
Supported Countries	United States
Subscriptions	No
Min Amount	$0.50
Settlement	Up to 4 business days

ACH Direct Debit은 즉시 처리되지 않습니다. 결제가 성공하거나 실패하기까지 최대 영업일 4일이 걸릴 수 있습니다. 승인된 debit은 정산된 결제가 아닙니다. 결제가 succeeded 상태에 도달한 후에만 주문을 처리하세요.

작동 방식

고객 경험

고객이 checkout에서 ACH Direct Debit을 선택합니다.
고객이 account holder name, routing number, account number, account type(checking 또는 savings), email address를 입력합니다. Checkout에서 routing number가 유효한지 확인합니다.
고객이 양식을 제출하면 mandate에 따라 US bank account에서 debit이 이루어지도록 승인합니다.
payment가 ACH network로 제출되고 processing 상태가 됩니다. Clearing을 기다리지 않고 checkout이 완료됩니다.
이후 영업일 동안 clearing이 완료됩니다.
payment가 succeeded 상태로 전환되거나, bank에서 반환하면 실패합니다.

Clearing은 비동기적으로 처리되므로 checkout redirect 대신 webhooks를 사용해 최종 결과를 확인하세요. checkout 후 redirect는 고객이 debit을 승인했다는 의미일 뿐입니다.debit이 제출되면 payment에서 payment.processing를 emit하고, clearing이 완료되면 payment.succeeded 또는 payment.failed를 emit합니다. payment.succeeded에서만 주문을 처리하세요.

제공 조건

다음 조건을 모두 충족하면 체크아웃에 ACH Direct Debit이 표시됩니다:

billing currency는 USD입니다.
billing country는 US입니다.
거래는 일회성 결제입니다.

ACH Direct Debit은 subscriptions에 사용할 수 없습니다. recurring payments에는 cards 또는 subscriptions를 지원하는 다른 method를 사용하세요. Payment Methods overview를 참조하세요.

구성

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['ach', 'credit', 'debit'],
  billing_currency: 'USD',
  billing_address: {
    country: 'US',
    zipcode: '94102'
  },
  return_url: 'https://example.com/success'
});

ACH Direct Debit에는 USD billing currency와 US billing address가 필요합니다. 다른 currency로 가격을 책정하는 경우 Adaptive Currency를 활성화하면 US 고객에게 USD로 청구되어 ACH를 사용할 수 있습니다.

API Method Type

Type	Method	Country
`ach`	ACH Direct Debit	미국

환불 및 분쟁

ACH payment의 환불과 dispute는 다른 모든 payment method와 동일한 API 및 dashboard flow를 사용합니다. ACH 전용 처리는 필요하지 않습니다.

고객의 bank는 ACH debit이 처리된 것처럼 보인 후에도 이를 반환할 수 있으며, Nacha rules에 따라 고객은 settlement 후 최대 60 calendar days 동안 personal account에서 발생한 unauthorized debit을 반환할 수 있습니다. 원래 payment가 succeeded 상태에 도달하기 전에는 환불하지 마세요.

테스트

Enable test mode

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

Set currency and billing address

청구 통화를 USD로 설정하고 청구 주소의 국가를 US로 설정하세요.

Include ach in allowed methods

ach를 allowed_payment_method_types에 전달하거나, 모든 eligible method를 표시하려면 field를 생략하세요.

Enter the test bank details

아래의 test routing number와 account number pair 중 하나를 입력하세요. 그런 다음 webhook handler가 최종 payment status를 수신하는지 확인하세요.

테스트 은행 계좌

고객은 checkout form에 account number와 routing number를 입력합니다. test mode에서는 routing number 110000000를 다음 account number 중 하나와 함께 사용해 결과를 강제로 지정할 수 있습니다:

Account Number	Routing Number	Behavior
`000123456789`	`110000000`	payment가 성공합니다.
`000222222227`	`110000000`	자금 부족으로 payment가 실패합니다.
`000111111113`	`110000000`	account가 폐쇄되어 payment가 실패합니다.
`000111111116`	`110000000`	account를 찾을 수 없어 payment가 실패합니다.
`000333333335`	`110000000`	account에서 debit이 승인되지 않아 payment가 실패합니다.
`000444444440`	`110000000`	유효하지 않은 currency로 인해 payment가 실패합니다.
`000555555559`	`110000000`	payment가 성공한 후 dispute가 발생합니다.
`000000000009`	`110000000`	payment가 processing 상태에 무기한으로 머뭅니다. pending-state UI 테스트에 사용하세요.

Test payment는 live payment보다 훨씬 빠르게 최종 status에 도달하므로 integration을 확인하기 위해 며칠을 기다릴 필요가 없습니다. 예외는 000000000009이며, processing 상태로 유지됩니다.

모범 사례

Don't fulfill on authorization

ACH authorization은 payment가 아닙니다. access를 허용하거나 상품을 배송하기 전에 payment가 succeeded 상태에 도달할 때까지 기다리세요. 고객의 bank는 여전히 debit을 반환할 수 있습니다.

Set customer expectations at checkout

bank payment는 즉시 clearing되지 않는다고 고객에게 안내하세요. 이렇게 하면 주문이 아직 pending 상태인 이유를 묻는 support ticket을 줄일 수 있습니다.

Provide card fallbacks

즉시 product에 access해야 하는 고객이 더 빠른 method를 선택할 수 있도록 ach와 함께 credit 및 debit를 포함하세요.

Use ACH for high-value one-time purchases

ACH fee는 $15로 상한이 적용되므로 대규모 일회성 구매에서 절감액이 가장 큽니다.

문제 해결

ACH not appearing at checkout

확인:

billing currency가 USD인가요?
고객의 billing country가 US인가요?
ach가 allowed_payment_method_types에 포함되어 있나요?
일회성 결제인가요? ACH는 subscriptions에 제공되지 않습니다.
금액이 최소 $0.50 이상인가요?

해결 방법: 모든 eligible method를 확인하려면 allowed_payment_method_types를 일시적으로 제거한 다음 API request에서 billing currency와 address country를 확인하세요.

ACH not appearing on a subscription checkout

원인: ACH Direct Debit은 일회성 결제에만 제공됩니다.해결 방법: 반복 청구에는 카드 또는 구독을 지원하는 다른 수단을 사용하세요.

Payment stuck in processing

원인: 예상된 동작입니다. ACH payment는 전체 clearing window 동안 processing 상태로 유지되며, 이는 card payment보다 훨씬 깁니다.해결 방법: 최종 webhook을 기다리세요. retry하면 고객에게 두 번 debit될 수 있으므로 payment를 retry하지 마세요.

Payment failed after initially succeeding at checkout

원인: checkout은 완료되었지만 clearing 중 고객의 bank가 debit을 반환했습니다. 대부분 자금 부족 또는 폐쇄된 account가 원인입니다. payment에서 payment.failed를 emit합니다.해결 방법: payment를 실패로 처리하고 고객에게 다른 method로 결제하도록 요청하세요. 이를 방지하려면 succeeded 상태에서만 주문을 처리하세요.

Payment Methods Overview

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

Adaptive Currency

통화 지원 및 자동 변환.

Checkout Guide

체크아웃 구현 전체 가이드.

Webhooks

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

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

ACH Direct Debit을 제공하는 이유

Lower Processing Cost

No Card Required

Higher Value Orders

개요

작동 방식

고객 경험

제공 조건

구성

API Method Type

환불 및 분쟁

테스트

테스트 은행 계좌

모범 사례

문제 해결

관련 페이지

Payment Methods Overview

Adaptive Currency

Checkout Guide

Webhooks

​ACH Direct Debit을 제공하는 이유

Lower Processing Cost

No Card Required

Higher Value Orders

​개요

​작동 방식

​고객 경험

​제공 조건

​구성

​API Method Type

​환불 및 분쟁

​테스트

​테스트 은행 계좌

​모범 사례

​문제 해결

​관련 페이지

Payment Methods Overview

Adaptive Currency

Checkout Guide

Webhooks

ACH Direct Debit을 제공하는 이유

개요

작동 방식

고객 경험

제공 조건

구성

API Method Type

환불 및 분쟁

테스트

테스트 은행 계좌

모범 사례

문제 해결

관련 페이지