ペイメントだけでなく、ホストページはカスタマーを作成することも出来ます。カスタマーとは長期的に顧客の支払い情報を保存するリソースです。

1: mode=customerを指摘してセッションを作成

セッションを作成する際には、ペイメントモードがデフォルトになっていますが、"mode": "customer"を指定するとペイメントの代わりにカスタマーリソースが作成されます。

カスタマーモードで作成されたセッションにはcustomer_idが含まれています。このcustomer_idを保存いただくことで、後にペイメントを作る時にpayment_detailsの代わりにcustomer_idを使うことが出来ます。

ペイメントモードと同様に、セッションを作成したあと顧客をsession_urlにリダイレクトさせます。

2: customer.updated webhookを受信

Step 1でcustomer_idを得られましたが、顧客がセッションを完了させるまでこれを使用することはできません。customer_idが利用できるようになると、customer.updatedというwebhookが送信されます。webhookについては、webhookのドキュメントをご参考ください。

3: customer_idを使用してペイメントを作成

customer_idが利用可能になると、これを使ってペイメントを作成できます。ペイメントを作成するAPIでpayment_detailsの代わりにcustomerを渡します。