Checkout SDK（NFT向けカード決済）

@0xsequence/checkout を使って、パートナー（例：Transak、Forte）経由でNFT購入時にクレジット／デビットカード決済を追加できます。

カード決済処理はパートナーによって行われます。導入には、カード決済有効化前にパートナーとのKYBおよびコントラクトの許可リスト登録が必要です。Sequenceは決済処理の引受や運営は行いません。

対応プロセッサー：Transak および Forte。 主に主要なEVMチェーンをカバーしており、詳細はパートナーによります。パートナーの判断で新しいEVMチェーンの追加も検討されます。まずはSequenceにご連絡いただければ、適切なパートナーをご紹介します。

​

Checkout SDKを使うタイミング

• ERC-1155 / ERC-721アイテムを販売しており、暗号資産に加えてカード決済も提供したい場合。
• パートナーのKYBおよび許可リスト登録を完了できる場合。
• 支払い方法の選択や購入処理をまとめて行えるドロップインモーダルを利用したい場合。

​

インストール方法

pnpm add @0xsequence/checkout @0xsequence/connect

​

基本セットアップ

import { SequenceConnect } from '@0xsequence/connect'
import { SequenceCheckoutProvider } from '@0xsequence/checkout'
import { config } from './config'

export default function App() {
  return (
    <SequenceConnect config={config}>
      <SequenceCheckoutProvider>
        <YourRoutes />
      </SequenceCheckoutProvider>
    </SequenceConnect>
  )
}

​

例：カスタムコントラクト呼び出し

import { useAccount } from 'wagmi'
import { useSelectPaymentModal, type SelectPaymentSettings } from '@0xsequence/checkout'
import { encodeFunctionData } from 'viem'

export function CustomBuy() {
  const { address } = useAccount()
  const { openSelectPaymentModal } = useSelectPaymentModal()

  const onClick = () => {
    if (!address) return

    const chainId = 137
    const salesContract = '0xSaleContract'
    const currency = '0xUSDC'
    const collection = '0xERC1155'
    const price = '20000' // align with your contract's decimals

    const erc1155MintAbi = [{ /* ...mint signature matching your contract... */ }]
    const txData = encodeFunctionData({
      abi: erc1155MintAbi,
      functionName: 'mint',
      args: [address, /* tokenIds[] */, /* amounts[] */, /* data */, currency, price, /* proof */]
    })

    const settings: SelectPaymentSettings = {
      chain: chainId,
      targetContractAddress: salesContract,
      recipientAddress: address,
      currencyAddress: currency,
      collectionAddress: collection,
      price,
      collectibles: [{ tokenId: '1', quantity: '1' }],
      // creditCardProviders: ['transak', 'forte'],
      onSuccess: (txHash) => console.log('success', txHash),
      onError: (err) => console.error(err),
      txData,
    }

    openSelectPaymentModal(settings)
  }

  return <button onClick={onClick}>Buy (custom)</button>
}

​

パートナー設定（カード）

1. Sequenceに連絡

   ご利用用途についてSequenceまでご相談ください。適切な場合はTransakまたはForteをご紹介します。

2. パートナーアカウント作成 & KYB

   対応プロバイダー（例：TransakまたはForte）でアカウントを作成し、KYBを完了してください。

3. コントラクトの許可リスト登録

   カード決済で利用する販売コントラクトをパートナーに許可リスト登録してもらってください。

4. プロバイダーの設定

   利用するパートナーを限定したい場合は、creditCardProvidersで許可プロバイダーを指定します。

5. 本番公開

   パートナー要件に従い主要なEVMチェーンで有効化し、実際のカードで購入テストを行ってください。

暗号資産のみの購入や「任意のトークン／チェーン」からの支払いには、Trailsをご利用ください。Checkout SDKはNFT購入のカード決済に特化しており、Trailsやウォレット決済と併用できます。

​

参考情報

• Web SDKチェックアウトガイド
• Trails概要