顧客を作成する

カード情報のトークンを使って顧客を作成することで、定期課金を作成して継続的に課金を行ったり、2回目以降の支払い時に登録されているカード情報を使って支払いを行ったりできます。

カード情報のトークンから顧客を作成する

下記のようなリクエストでカード情報のトークンから、顧客を作成することができます。

curl https://api.pay.jp/v1/customers \
-u sk_test_c62fade9d045b54cd76d7036: \
-d "card=カード情報のトークン"

顧客作成時にはカード情報の他に、idを指定したりメールアドレスを登録したりすることもできます。 またカード情報は紐つけないまま顧客を作成し、後からカード情報のみ追加することもできます。 より詳しくはAPIリファレンスの 顧客を作成 をご参照ください。

すでに存在する顧客に追加でカード情報を登録する

下記のようなリクエストでカード情報のトークンをすでに存在する顧客に追加することができます

curl https://api.pay.jp/v1/customers/{顧客のid}/cards \
-u sk_test_c62fade9d045b54cd76d7036: \
-d "card=カード情報のトークン"

トークンは顧客に複数紐付けることができ、それぞれのカードに対してカード情報の編集カード情報の削除ができます。

一番最初に紐付けられたカード情報は default_card として登録されます。 顧客情報を使った支払い作成時にカードの指定を省略した場合や定期課金ではこの default_card に指定されたカードを使って処理が行われます。

登録した顧客を使って定期課金を行う方法については、定期課金をご覧ください。

顧客のデフォルトカードを更新する

有効期限が切れた場合など、顧客に紐づけられたカードを更新したい場合は新規に顧客のカードを登録し、そのカードIDを指定して顧客のデフォルトカードを登録することで支払いに使われるカードを切り替えることができます。

すでに存在する顧客に追加でカード情報を登録するの手順でカードを追加で登録し、レスポンスに含まれるカードID( car_ から始まる文字列 )を取得し、そのIDを default_card に指定することで更新できます。

curl https://api.pay.jp/v1/customers/{顧客のid} \
-u sk_test_c62fade9d045b54cd76d7036: \
-d "default_card={car_から始まるカードID}"

※すでに登録されたカードの有効期限やCVCを更新することはできません。
カードの更新時はpayjp-jscheckoutなどのクライアントライブラリから新規にトークンを作成しカードを追加登録していただくようお願いいたします。