{
"openapi": "3.0.2",
"info": {
"title": "M's PayBridge API",
"description": "M's PayBridgeのAPIリファレンスです。\\\nM's PayBridgeは決済情報のほか様々なリソースを管理できるため、リソース指向なREST APIをベースとしたインターフェイス設計のもとでAPIを提供しています。\\\nAPIの呼び出しにはAPIキーによる認証が必要であり、リクエストの際に`Authorization`ヘッダーに有効なAPIキーをセットすることで認証できます。\n",
"version": "1.0.0"
},
"servers": [
{
"url": "https://api.fincode.jp",
"description": "本番環境"
},
{
"url": "https://api.test.fincode.jp",
"description": "テスト環境"
}
],
"tags": [
{
"name": "文字コード",
"description": "M's PayBridgeのリクエスト・レスポンスの文字コードはUTF-8が使用されます。\n| 文字コード | 備考 |\n| --- | --- |\n| UTF-8 | M's PayBridgeのリクエスト・レスポンスの文字コードはUTF-8が使用されます。 |\n",
"x-trailTag": true,
"file": "guides/guide-1.md"
},
{
"name": "リクエストヘッダー",
"description": "M's PayBridgeのAPIリクエストを行う際に指定可能なリクエストヘッダーの一覧です。\n| ヘッダー | 指定方法 | 説明 |\n| --- | --- | --- |\n| `Api-Version` | YYYYMMDD | APIのマイナーバージョンを指定できます。（現在は`20211001`）
指定が無い場合は最新のものが自動で使用されます。 |\n| `Authorization` | Bearer {{API キー}}
または Basic {{Base64エンコード済みAPIキー}} | APIキーを指定します。Bearer認証またはBasic認証が使用できます。|\n| `Content-Type` | application/json;charset=UTF-8 | リクエストボディのContent-Typeを指定します。 |\n| `idempotent_key`| UUID v4 | リクエストの冪等性を担保するためのキーを指定します。詳しくは[冪等処理](https://mpb-mizuhobank-docs.fincode.jp/api#tag/%E5%86%AA%E7%AD%89%E5%87%A6%E7%90%86)で解説されています。 |\n| `Tenant-Shop-Id` | テナントのショップID | ※プラットフォーム向け
テナントショップの決済を行うときなど、プラットフォームショップがテナントショップとしてAPIを実行する場合、そのテナントのショップIDを指定します。|\n",
"file": "guides/guide-2.md"
},
{
"name": "ページネーション",
"description": "一覧取得系のAPIは大量データの送信を防ぐためにページング機能が実装されています。\\\n取得対象の件数が10件以上の場合、デフォルトでは最大10件まで取得します。\\\n以降のデータを取得したい場合や10件以上のデータを取得したい場合、クエリパラメータでpageやlimitを指定することで取得できます。\\\nまた、取得したいデータを絞るために検索条件を指定することができます。検索できる項目は各APIによって異なります。\n\n| No | 項目名 | パラメータ | 内容 | デフォルト | 範囲 | 処理条件 |\n|----|----------------------|---------------|------------------------------------|------------------------|------------|---------------------------------------------------------------------------------------------------------------|\n| 1 | 取得件数 | limit | 1ページの最大件数 | 10 | 10-100 | 指定されない場合デフォルト値が適用されます。
データ範囲外はエラーになります。 |\n| 2 | ページ | page | ページ数 | 1 | 1-9999 | 指定されない場合デフォルト値が適用されます。
レスポンスのlast_page（最終ページ）より大きい数字を指定した場合はエラーを返却します。 |\n| 3 | 総件数のみフラグ | count_only | 総件数のみを取得する | false | - | trueが指定された場合は、指定された条件に合致するレコード総件数のみをレスポンスとして返却します。 |\n| 4 | ソート | sort | ソート順の定義 | APIのデフォルト値 | - | sort=項目名1 [asc \\| desc], 項目名2 [asc \\| desc], …
例) sort=customer_id asc, customer_name asc, customer_email desc
指定がない場合は各API デフォルトのソート順となります。
指定された項目がないまたはフォーマットが不正な場合はエラーになります。
総件数のみフラグがtrueの場合、このリクエストは無視されます。 |\n\n### サンプル①\n[顧客 一覧取得API](https://mpb-mizuhobank-docs.fincode.jp/api#tag/%E9%A1%A7%E5%AE%A2/operation/retrieveCustomerList)で顧客IDを昇順にソートして、2ページ目のデータを取得する例\n```txt\nhttps://api.test.fincode.jp/v1/customers?page=2&sort=id asc\n```\n\n### サンプル②\n[顧客 一覧取得API](https://mpb-mizuhobank-docs.fincode.jp/api#tag/%E9%A1%A7%E5%AE%A2/operation/retrieveCustomerList)で検索条件で作成日を2023/06/28に限定して、2ページ目のデータを取得する例\n```txt\nhttps://api.test.fincode.jp/v1/customers?page=2&created_from=2023/06/28&created_to=2023/06/28\n```\n\n### サンプル③\n[顧客 一覧取得API](https://mpb-mizuhobank-docs.fincode.jp/api#tag/%E9%A1%A7%E5%AE%A2/operation/retrieveCustomerList)で顧客の総件数のみを取得する例\n```txt\nhttps://api.test.fincode.jp/v1/customers?count_only=true\n```\n",
"file": "guides/guide-3.md"
},
{
"name": "冪等処理",
"description": "加盟店様がAPIリクエストのリクエストヘッダー`idempotent_key`に冪等キー（任意）を設定することで、リクエストを一意に特定し、2回目以降のリクエストで同じ結果を返却します。\n本機能を利用すると同じリソースが誤って二重に作られてしまうような事態を避けることができます。\n\nUUIDv4形式で、リクエスト毎にユニークになるよう値を指定してください。 \n冪等キーの有効期限は30分です。\n\n### サンプル\n```txt\nidempotent_key: 1003d6af-9e68-4f4e-a916-663e29db5377\n```\n",
"file": "guides/guide-4.md"
},
{
"name": "エラーオブジェクト",
"description": "HTTPステータスコード`4xx`系と`5xx`系のエラーが発生した場合、API共通のエラーオブジェクトを返します。\\\n`error_message`の値がエラー原因に該当します。内容に応じて修正してください。 \\\n※`error_message`は予告無く変更される場合があります。開発時の問題解決の為にご利用下さい。\\\n\\\n[DOCSのエラーコード一覧](https://mpb-mizuhobank-docs.fincode.jp/develop_support/error)からも詳細を確認できます。\n\n### サンプル, エラーは`errors`の値として配列形式でレスポンスされます。\n```json\n{\n \"errors\": [\n {\n \"error_code\": \"E123456789\",\n \"error_message\": \"エラー内容1\"\n },\n {\n \"error_code\": \"E012345678\",\n \"error_message\": \"エラー内容2\"\n },\n ]\n}\n```\n\n| パラメータ | | 説明 |\n| --- | --- | ---|\n| errors | | エラーオブジェクトの配列です。 |\n| | error_code | エラーコードです。プログラムで判定する場合はこちらを利用することが推奨されます。
詳細は[Docs > エラーコード一覧](https://mpb-mizuhobank-docs.fincode.jp/develop_support/error)を参照してください。|\n| | error_message | エラーメッセージです。エラーの内容を示します。
この値は予告なく変更される可能性があります。|\n",
"file": "guides/guide-5.md"
},
{
"name": "エラー",
"description": "APIリクエスト後、以下のHTTPステータスコードとともにレスポンスがされます。\n| ステータスコード | 意味 | 説明 |\n| --- | --- | --- |\n| 200 | OK | リクエストが成功しました。 |\n| 400 | Bad Request | 不正なリクエストです。リクエストパラメータとJSONの形式を確認してください。 |\n| 401 | Unauthorized | 認証されていません。APIキーを確認してください。 |\n| 403 | Forbidden | APIを使用する権限がありません。アクセス先を確認してください。または流量制限を超えている可能性があります。リクエストレートを減らしてください。 |\n| 404 | Not Found | 指定したAPIが存在しません。アクセス先を確認してください。 |\n| 405 | Method Not Allowed | 無効なHTTPメソッドへの要求です。HTTPメソッドを確認してください。 |\n| 406 | Not Acceptable | 要求されたリソースが受け入れられないコンテンツしか生成できないことを意味します。Acceptヘッダーを確認してください。 |\n| 409 | Conflict | リソースの競合が発生しています。要求を処理できませんでした。 |\n| 413 | Payload Too Large | 送信できるファイルサイズの上限を超えています。 |\n| 415 | Unsupported Media Type | サーバーまたはリソースがサポートしていないメディアタイプが指定されました。リクエストヘッダーのメディアタイプを確認してください。 |\n| 500 | Internal Server Error | サーバーでエラーが発生したため、要求を完了できませんでした。 |\n| 502 | Bad Gateway | ゲートウェイエラーです。プロキシサーバーの使用中など、あるサーバーが別のサーバーから無効なリクエストを受信したことを意味します。 |\n| 503 | Service Unavailable | メンテナンス中による流入制限です。 |\n| 504 | Gateway Timeout | ゲートウェイタイムアウトが発生しました。 |\n",
"file": "guides/guide-6.md"
},
{
"name": "顧客",
"description": "顧客を管理するAPIです。M's PayBridgeにおける顧客は多くのアプリケーションにおいて購入者となるユーザーアカウントに1:1で紐づけられます。\\\n顧客には名前やメールアドレス、請求先住所を登録し管理でき、決済やカード情報・決済手段などのリソースが関連付けられます。\n"
},
{
"name": "カード",
"description": "顧客が持つカードを管理するAPIです。\\\nカードにはクレジットカード/デビッドカード/プリペイドカードの有効期限や名義などの情報が含まれており、決済の実行時にカードのIDを指定することでそのカードに対して請求（決済）を行います。\\\n\\\n1つの顧客に対してカード情報は最大5件まで登録可能です。5件登録している状態で新しいカードを登録する場合は、既存のカードを削除してから再度登録してください。\\\n\\\n※ カード登録時に3Dセキュア認証を行う場合は、[決済手段 登録API](#tag/PaymentMethod/operation/createCustomerPaymentMethod)を使用します。\n"
},
{
"name": "決済手段",
"description": "顧客が持つ決済手段（*Payment Method*）を管理するAPIです。\\\n決済実行の際に決済手段のIDを指定することで、その決済手段に対し請求（決済）をします。\\\n\\\n決済手段オブジェクトは`pay_type`パラメータの値によって下記の情報を表現します。\n\n- `Card`: この決済手段はカードを表します。`card`パラメータ内にカードに関する詳細な情報が含まれます。\n- `Directdebit`: この決済手段は口座振替における振替用口座を表します。`directdebit`パラメータ内に口座に関する詳細な情報が含まれます。\n- `Virtualaccount`: この決済手段は銀行振込（バーチャル口座）を表します。`virtualaccount`パラメータ内に口座に関する詳細な情報が含まれます。\n\n1つの顧客に対して同一`pay_type`の決済手段は最大5件まで登録可能です。5件登録している状態で新しい決済手段を登録する場合は、既存の決済手段を削除してから再度登録してください。\\\n\\\n※カード情報の操作はカードAPIでも可能ですが、今後は非推奨となる予定です。新規実装および機能追加を行う場合は、決済手段APIの利用を推奨します。\\\n\\\n[更に詳しく解説したドキュメントをこちらから参照できます。](https://mpb-mizuhobank-docs.fincode.jp/payment/payment_method)\n"
},
{
"name": "決済",
"description": "決済を行うAPIです。\\\n決済 登録APIで決済情報をM's PayBridgeに登録し、決済 実行APIで実際に購入者（顧客）に対して請求を行います。\\\n\\\n決済手段によっては決済実行後、3Dセキュア認証や購入者による現金払い込みなどが必要になります。\n"
},
{
"name": "3Dセキュア認証",
"description": "3Dセキュア認証を行うAPIです。\\\n3Dセキュア認証はカード決済において不正利用を防止するために使用される本人認証の仕組みです。\\\n\\\n決済実行後、購入者が`acs_url`にアクセスすると、ブラウザ情報がM's PayBridgeへ送信され認証プロセスが開始します。認証のプロセスと実装のフローに関しては[Docs > 3Dセキュア2.0認証を使用する](https://mpb-mizuhobank-docs.fincode.jp/payment/fraud_protection/3d_secure_2)から参照できます。\n"
},
{
"name": "リダイレクト型決済",
"description": "M's PayBridgeが提供するリダイレクト型決済URLを作成するAPIです。\\\nリクエスト時に`guide_mail_send_flag`（決済メール送信フラグ）に`1`（送信する）を指定することでリダイレクト型決済URLを添付したメールをM's PayBridgeから送信させられます。\n"
},
{
"name": "リダイレクト型カード登録",
"description": "リダイレクト型カード登録URLを作成するAPIです。\n\n- 顧客ID（`customer_id`）を指定して作成した場合、その顧客に対してカードを登録するためのカード登録URLを発行します。\n- 顧客IDを指定しなかった場合、顧客を新たに作成しその顧客に対してカードを登録するためのカード登録URLを発行します。\n\nリクエスト時に`guide_mail_send_flag`（登録メール送信フラグ）に`1`（送信する）を指定することでリダイレクト型カード登録URLを添付したメールをM's PayBridgeから送信させられます。\n"
},
{
"name": "プラン",
"description": "サブスクリプションのプランを管理するAPIです。\\\nサブスクリプション請求の金額・間隔・頻度などのプラン情報を登録・取得・更新・削除できます。\n"
},
{
"name": "サブスクリプション",
"description": "サブスクリプションを管理するAPIです。\\\n指定した顧客に対して指定したプランで定期・定額で請求を行うサブスクリプションを登録・更新・削除できるほか、結果照会APIを用いてあるサブスクリプションによって発生した毎回の課金の結果を一覧で取得することもできます。\\\n\\\nサブスクリプション課金の処理は非同期で行われ、Webhookイベント`recurring.card.batch`（サブスクリプション課金（カード決済） 実行）や`recurring.directdebit.batch`（サブスクリプション課金（口座振替） 実行）で課金結果を受け取ることができます。\n"
},
{
"name": "一括決済",
"description": "一括決済を行うAPIです。\\\n数千・数万件単位の決済を1回のリクエストで登録・予約することができ、従量課金のビジネスモデルの構築などに利用できます。\\\n\\\n一括決済の処理は非同期で行われ、Webhookイベント`payments.bulk.*.batch`（一括決済課金 実行）で課金結果を受け取ることができます。\n"
},
{
"name": "インボイス機能",
"description": "インボイス機能に関するAPI群です。\\\n機能の詳細は[こちら](/payment/invoice)をご確認ください。\\\nインボイス情報をもとに決済機能付きの請求書と領収書が発行されます。\n"
},
{
"name": "請求管理",
"description": "請求管理を行うAPI群です。\\\nメールリンクやインボイス機能を用いて請求を行うことができます。\n"
},
{
"name": "売上入金",
"description": "ショップの売上入金を取得できます。\\\nまた、ある売上入金の詳細情報を取得し、取引1件ごとの入金額への影響を確認することもできます。\n"
},
{
"name": "プラットフォーム利用料収入",
"description": "プラットフォーム利用料による売上入金を取得できます。\\\nまた、ある売上入金のIDを指定して、テナントショップごとの入金のサマリー情報を一覧取得することもできます。\n"
},
{
"name": "チャージバック",
"description": "チャージバックに関する情報を取得できるAPIです。\\\nチャージバックに関する詳細は[Docs](https://mpb-mizuhobank-docs.fincode.jp/business_management/chargeback)をご確認ください。\n\nショップ管理画面のチャージバックステータスは、APIの`status_code`と`canceled`パラメータで取得できます。\\\nステータスごとの対応は以下の通りです。\n\n**要対応**\n- `status_code`: 4005\n- `canceled`: 使用なし\n\n**回答済み**\n- `status_code`: 4006、4007、4011\n- `canceled`: 使用なし\n\n**売上返還確定**\n- `status_code`: 4009\n- `canceled`: false\n\n**その他（確定後取消）**\n- `status_code`: 4009\n- `canceled`: true\n"
},
{
"name": "プラットフォームショップ",
"description": "プラットフォームショップ（メインショップ・サブショップ）の設定を管理するAPIです。\\\nテナントに対し適用するプラットフォーム利用料金の設定や、プラットフォームショップの一覧取得などができます。\n"
},
{
"name": "テナントショップ",
"description": "テナントショップの設定を管理するAPIです。\\\nテナントに対し適用するプラットフォーム利用料金の設定や、テナントショップの一覧取得などができます。\n"
},
{
"name": "テナント申請管理",
"description": "テナントショップの新規作成や審査情報の提出、販売免許等のアップロードなどを行えるAPIです。\\\n\\\nこのAPIの利用について\\\nこのAPIを本番環境で利用するためにはM's PayBridgeへの申請が必要です。利用を希望する場合は[問い合わせフォーム](https://www.faq.mizuhobank.co.jp/helpdesk?category_id=645&site_domain=houjin) からテナント申請管理APIを利用するサービスの概要をお知らせの上、機能開放をリクエストしてください。（テスト環境では常時利用できます。）\n"
},
{
"name": "社印",
"description": "ショップに紐づく社印を管理するAPIです。\\\n登録された社印は、インボイス機能などで発行される請求書・領収書・インボイスWEBページに自動で押印されます。\\\n画像はマルチパート形式でアップロードします。サポートする拡張子は `png` / `jpg` / `jpeg` です。\n"
},
{
"name": "ショップ決済手段",
"description": "ショップに紐づく決済手段（*Shop Payment Method*）を管理する API です。\\\n\\\n決済手段オブジェクトは`pay_type`パラメータの値によって下記の情報を表現します。\n- `Payeeaccount`: この決済手段は銀行振込（指定口座）を表します。`payee_account`パラメータ内に口座に関する詳細な情報が含まれます。\\\n1つのショップに対して同一`pay_type`の決済手段は最大5件まで登録可能です。5件登録している状態で新しい決済手段を登録する場合は、既存の決済手段を削除してから再度登録してください。\n"
},
{
"name": "Webhook設定",
"description": "Webhook設定を管理するAPIです。\\\nM's PayBridge上で指定したイベントが発生した場合、指定したエンドポイントでリアルタイムで通知を受け取れます。\\\n[Webhook通知仕様はこちら](https://mpb-mizuhobank-docs.fincode.jp/api#tag/Webhook_)\\\n\\\n※1 テナントのイベントを受けとるためにはテナントごとにWebhook設定を登録する必要があります。\n\n| 機能 | イベント名 | イベントパラメータ |\n|----------------------------|--------------------------|-----------------------------------------|\n| カード決済 | 決済登録 | payments.card.regist |\n| カード決済 | 決済実行 | payments.card.exec |\n| カード決済 | 売上確定 | payments.card.capture |\n| カード決済 | キャンセル | payments.card.cancel |\n| カード決済 | 再オーソリ | payments.card.auth |\n| カード決済 | 金額変更 | payments.card.change |\n| 3Dセキュア（カード決済） | 認証実行 | payments.card.secure2.authenticate |\n| 3Dセキュア（カード決済） | チャレンジ結果確定 | payments.card.secure2.result |\n| 3Dセキュア（カード決済） | 認証後決済実行 | payments.card.secure |\n| Apple Pay | 決済登録 | payments.applepay.regist |\n| Apple Pay | 決済実行 | payments.applepay.exec |\n| Apple Pay | 売上確定 | payments.applepay.capture |\n| Apple Pay | キャンセル | payments.applepay.cancel |\n| Google Pay | 決済登録 | payments.googlepay.regist |\n| Google Pay | 決済実行 | payments.googlepay.exec |\n| Google Pay | 売上確定 | payments.googlepay.capture |\n| Google Pay | キャンセル | payments.googlepay.cancel |\n| Google Pay | 再オーソリ | payments.googlepay.auth |\n| Google Pay | 金額変更 | payments.googlepay.change |\n| 3Dセキュア（Google Pay） | 認証実行 | payments.googlepay.secure2.authenticate |\n| 3Dセキュア（Google Pay） | チャレンジ結果確定 | payments.googlepay.secure2.result |\n| 3Dセキュア（Google Pay） | 認証後決済実行 | payments.googlepay.secure |\n| コンビニ決済 | 決済登録 | payments.konbini.regist |\n| コンビニ決済 | 決済実行 | payments.konbini.exec |\n| コンビニ決済 | キャンセル | payments.konbini.cancel |\n| コンビニ決済 | 支払通知 | payments.konbini.complete |\n| コンビニ決済 | 支払通知（シミュレート） | payments.konbini.complete.stub |\n| コンビニ決済 | 支払い期限切れ | konbini.expired.update.batch |\n| PayPay | 決済登録 | payments.paypay.regist |\n| PayPay | 決済実行 | payments.paypay.exec |\n| PayPay | 売上確定 | payments.paypay.capture |\n| PayPay | キャンセル | payments.paypay.cancel |\n| PayPay | 金額変更 | payments.paypay.change |\n| PayPay | 支払通知 | payments.paypay.complete |\n| 口座振替 | 決済登録 | payments.directdebit.regist |\n| 口座振替 | 決済実行 | payments.directdebit.exec |\n| 口座振替 | キャンセル | payments.directdebit.cancel |\n| 口座振替 | 金額変更 | payments.directdebit.change |\n| 口座振替 | 引き落とし通知 | payments.directdebit.complete |\n| 口座振替 | 引き落とし通知（シミュレート） | payments.directdebit.complete.stub |\n| 銀行振込（バーチャル口座） | 決済登録 | payments.virtualaccount.regist |\n| 銀行振込（バーチャル口座） | 決済実行 | payments.virtualaccount.exec |\n| 銀行振込（バーチャル口座） | キャンセル | payments.virtualaccount.cancel |\n| 銀行振込（バーチャル口座） | 支払通知 | payments.virtualaccount.complete |\n| 銀行振込（バーチャル口座） | 支払通知（シミュレート） | payments.virtualaccount.complete.stub |\n| 決済手段（※3） | 登録 | customers.payment_methods.created |\n| 決済手段（※2） | 更新 | customers.payment_methods.updated |\n| 決済手段（※3） | 停止 | customers.payment_methods.inactivated |\n| 決済手段（※3） | 再有効化 | customers.payment_methods.activated |\n| 決済手段（※3） | 削除 | customers.payment_methods.deleted |\n| カード（※2） | 登録 | card.regist |\n| カード | 更新 | card.update |\n| カード | カード更新機能（洗替） | card.updater.complete |\n| サブスクリプション（カード決済） | 登録 | subscription.card.regist |\n| サブスクリプション（カード決済） | 解約 | subscription.card.delete |\n| サブスクリプション（カード決済） | 更新 | subscription.card.update |\n| サブスクリプション課金（カード決済）| 実行 | recurring.card.batch |\n| サブスクリプション（口座振替） | 登録 | subscription.directdebit.regist |\n| サブスクリプション（口座振替） | 解約 | subscription.directdebit.delete |\n| サブスクリプション（口座振替） | 更新 | subscription.directdebit.update |\n| サブスクリプション課金（口座振替） | 実行 | recurring.directdebit.batch |\n| 一括決済（カード決済） | 登録 | payments.bulk.card.regist |\n| 一括決済課金（カード決済） | 実行 | payments.bulk.card.batch |\n| 一括決済（バーチャル口座） | 登録 | payments.bulk.virtualaccount.regist |\n| 一括決済課金（バーチャル口座） | 実行 | payments.bulk.virtualaccount.batch |\n| 決済手段 契約状況 | 更新 | contracts.status_code.updated |\n| チャージバック | 登録 | charge_backs.regist |\n| チャージバック | 更新 | charge_backs.update |\n| 変更申請 | 登録 | change_requests.regist |\n| 変更申請 | 更新 | change_requests.update |\n\n※2 リダイレクト型カード登録APIの結果通知を受け取るには決済手段 更新（customers.payment_methods.updated）のWebhook設定を登録する必要があります。\\\n※3 このイベントにおいて通知される決済手段はバーチャル口座のみです。カード、口座振替は通知されません。\n"
},
{
"name": "Webhook_通知仕様",
"description": "イベントが発生したときに、M's PayBridgeから加盟店様が設定したエンドポイントURLへWebhookのリクエストを送信するときの仕様です。\\\n[イベント一覧はこちら](https://mpb-mizuhobank-docs.fincode.jp/api#tag/Webhook)\\\n※通知対象のパラメータは、機能追加等に伴い追加される可能性があります。\\\n※予告なくパラメータ名の変更、削除が行われることはありません。\\\n\\\nWebhookを利用する場合は、正常受信または受信失敗のレスポンスをWebhookのリクエストに対して返却する必要があります。\\\nWebhookのリクエストがエラーで失敗した場合は、リトライ仕様に従って再送します。\n"
}
],
"externalDocs": {
"description": "M's PayBridgeJSの仕様はこちらの JSリファレンス から確認できます。",
"url": "/js"
},
"paths": {
"/v1/customers": {
"post": {
"security": [
{
"Secret-Bearer-Auth": []
},
{
"Secret-Basic-Auth": []
}
],
"operationId": "createCustomer",
"tags": [
"顧客"
],
"summary": "顧客 登録",
"parameters": [
{
"in": "header",
"name": "Tenant-Shop-Id",
"required": false,
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/schema"
}
]
},
"description": "※ 顧客情報を共有しないプラットフォームのメインショップのみ指定可\\\nテナントショップID。\\\n指定したテナントショップに紐づく形で顧客情報を登録します。\n"
}
],
"description": "顧客情報を登録します。\n",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Customer.Creating.Request"
}
}
}
},
"responses": {
"200": {
"description": "リクエストに成功",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Customer.Creating.Response"
}
}
}
},
"400": {
"description": "不正なリクエスト",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FincodeAPIError.Response"
}
}
}
}
},
"x-code-samples": [
{
"lang": "curl",
"label": "cURL",
"source": "curl \\\n -X POST \\\n -H \"Authorization:Bearer \" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"name\": \"John Doe\",\n \"email\": \"john@example.com\"\n}' \\\n'https://api.test.fincode.jp/v1/customers'\n"
},
{
"lang": "node",
"label": "Node.js",
"source": "import { createFincode } from \"@fincode/node\";\n\nconst API_KEY = \"\";\n\n(async () => {\n const fincode = createFincode({ apiKey: API_KEY, isLiveMode: false });\n\n try {\n // リクエストの送信\n const customer = await fincode.customers.create({\n name: \"John Doe\",\n email: \"john@example.com\",\n });\n } catch (e) {\n // エラーの処理\n }\n})();\n"
},
{
"lang": "go",
"label": "Go",
"source": "package main\n\nimport (\n\t\"bytes\"\n\t\"encoding/json\"\n\t\"fmt\"\n\t\"log\"\n\t\"net/http\"\n)\n\nfunc main() {\n\n\tapiKey := \"\"\n\n\tbody := CreatingCustomerRequest{\n\t\tEmail: stringPointer(\"john@example.com\"),\n\t\tName: stringPointer(\"John Doe\"),\n\t\tPhoneCC: stringPointer(\"81\"),\n\t\tPhoneNo: stringPointer(\"1234567890\"),\n\t}\n\n\tmarshalledBody, _ := json.Marshal(body)\n\n\t// リクエストの作成\n\treq, _ := http.NewRequest(\"POST\", \"https://api.test.fincode.jp/v1/customers\", bytes.NewBuffer(marshalledBody))\n\treq.Header.Set(\"Authorization\", fmt.Sprintf(\"Bearer %s\", apiKey))\n\treq.Header.Set(\"Content-Type\", \"application/json\")\n\n\t// リクエストの送信\n\tclient := &http.Client{}\n\tres, err := client.Do(req)\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\tdefer res.Body.Close()\n\n}\n\ntype CreatingCustomerRequest struct {\n\tID *string `json:\"id,omitempty\"`\n\tName *string `json:\"name,omitempty\"`\n\tEmail *string `json:\"email,omitempty\"`\n\tPhoneCC *string `json:\"phone_cc,omitempty\"`\n\tPhoneNo *string `json:\"phone_no,omitempty\"`\n\tAddrCity *string `json:\"addr_city,omitempty\"`\n\tAddrCountry *string `json:\"addr_country,omitempty\"`\n\tAddrLine1 *string `json:\"addr_line_1,omitempty\"`\n\tAddrLine2 *string `json:\"addr_line_2,omitempty\"`\n\tAddrLine3 *string `json:\"addr_line_3,omitempty\"`\n\tAddrPostCode *string `json:\"addr_post_code,omitempty\"`\n\tAddrState *string `json:\"addr_state,omitempty\"`\n}\n\nfunc stringPointer(s string) *string {\n\treturn &s\n}\n"
},
{
"lang": "php",
"label": "PHP",
"source": "';\n\n$baseUrl = \"https://api.test.fincode.jp\";\n$endpoint = \"/v1/customers\";\n$headers = [\n \"Authorization: Bearer \" . $apiKey,\n \"Content-Type: application/json\"\n];\n\n$data = json_encode([\n \"name\" => \"John Doe\",\n \"email\" => \"john@example.com\"\n]);\n\n$session = curl_init();\ncurl_setopt($session, CURLOPT_URL, $baseUrl . $endpoint);\ncurl_setopt($session, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($session, CURLOPT_POST, true);\ncurl_setopt($session, CURLOPT_POSTFIELDS, $data);\ncurl_setopt($session, CURLOPT_RETURNTRANSFER, true);\n// curl_setopt($session, CURLOPT_SSL_VERIFYPEER, );\n// curl_setopt($session, CURLOPT_SSL_VERIFYHOST, );\n\n$response = curl_exec($session);\n\nif ($response === false) {\n # エラー処理\n echo \"cURL Error: \" . curl_error($session);\n} else {\n # APIからのデータを処理\n var_dump($response);\n}\n\ncurl_close($session);\n"
},
{
"lang": "python",
"label": "Python 3",
"source": "import requests\n\napi_key = ''\n\nurl = f'https://api.test.fincode.jp/v1/customers'\n\n# ヘッダーを設定\nheaders = {\n 'Authorization': f'Bearer {api_key}',\n 'Content-Type': 'application/json'\n}\n\ndata = {\n \"name\": \"John Doe\",\n \"email\": \"john@example.com\"\n}\n\n# HTTP POSTリクエストの送信\ntry:\n response = requests.post(url, headers=headers, json=data)\n\n # レスポンスの処理\n if response.status_code == 200:\n # 成功した場合の処理\n print(f\"Success: {response.json()}\")\n else:\n # エラーの処理\n print(f\"Error: {response.json()}\")\nexcept requests.RequestException as e:\n # 通信エラーの処理\n print(f\"Request error: {e}\")\n"
},
{
"lang": "ruby",
"label": "Ruby",
"source": "require 'net/http'\nrequire 'uri'\nrequire 'json'\n\n\nAPI_KEY = ''\nBASE_URL = 'https://api.test.fincode.jp'\n\ndef main\n endpoint = \"/v1/customers\"\n uri = URI.parse(BASE_URL + endpoint)\n\n http = Net::HTTP.new(uri.host, uri.port)\n http.use_ssl = true\n\n data = {\n name: \"John Doe\",\n email: \"john@example.com\",\n }\n\n # リクエストの作成\n request = Net::HTTP::Post.new(uri.request_uri)\n request['Authorization'] = \"Bearer #{API_KEY}\"\n request['Content-Type'] = 'application/json'\n\n request.body = data.to_json\n\n # リクエストの送信\n response = http.request(request)\n\n case response\n when Net::HTTPSuccess\n puts 'SUCCESS'\n else\n puts 'ERROR'\n end\n\n # レスポンスの表示\n puts response.body\nend\n\nmain\n"
}
]
},
"get": {
"security": [
{
"Secret-Bearer-Auth": []
},
{
"Secret-Basic-Auth": []
}
],
"operationId": "retrieveCustomerList",
"tags": [
"顧客"
],
"summary": "顧客 一覧取得",
"description": "顧客情報を一覧で取得します。クエリパラメータを指定して取得する条件を絞り込めます。\n",
"parameters": [
{
"in": "query",
"name": "クエリ",
"description": "顧客情報の一覧取得において検索条件となるクエリパラメータ\n",
"required": false,
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/Pagination.QueryParams"
},
{
"$ref": "#/components/schemas/Customer.ListRetrieving.QueryParams"
}
]
}
},
{
"in": "header",
"name": "Tenant-Shop-Id",
"required": false,
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/schema"
}
]
},
"description": "※ 顧客情報を共有しないプラットフォームのメインショップのみ指定可\\\nテナントショップID。\\\nこのテナントショップに紐づく顧客から一覧で取得します。\n"
}
],
"responses": {
"200": {
"description": "リクエストに成功",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Customer.ListRetrieving.Response"
}
}
}
},
"400": {
"description": "不正なリクエスト",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FincodeAPIError.Response"
}
}
}
}
},
"x-code-samples": [
{
"lang": "curl",
"label": "cURL",
"source": "curl \\\n -X GET \\\n -H \"Authorization:Bearer \" \\\n'https://api.test.fincode.jp/v1/customers'\n"
},
{
"lang": "node",
"label": "Node.js",
"source": "import { createFincode } from \"@fincode/node\";\n\nconst API_KEY = \"\";\n\n(async () => {\n const fincode = createFincode({ apiKey: API_KEY, isLiveMode: false });\n\n try {\n // リクエストの送信\n const customers = await fincode.customers.retrieveList({\n limit: 10,\n });\n } catch (e) {\n // エラーの処理\n }\n})();\n"
},
{
"lang": "go",
"label": "Go",
"source": "package main\n\nimport (\n\t\"fmt\"\n\t\"log\"\n\t\"net/http\"\n)\n\nfunc main() {\n\n\tapiKey := \"\"\n\n\t// リクエストの作成\n\treq, _ := http.NewRequest(\"GET\", \"https://api.test.fincode.jp/v1/customers\", nil)\n\treq.Header.Set(\"Authorization\", fmt.Sprintf(\"Bearer %s\", apiKey))\n\n\tparams := req.URL.Query()\n\tparams.Add(\"limit\", \"10\")\n\treq.URL.RawQuery = params.Encode()\n\n\t// リクエストの送信\n\tclient := &http.Client{}\n\tres, err := client.Do(req)\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\tdefer res.Body.Close()\n\n}\n"
},
{
"lang": "php",
"label": "PHP",
"source": "';\n\n$baseUrl = \"https://api.test.fincode.jp\";\n$endpoint = \"/v1/customers\";\n$queryParams = [\n \"limit\" => 10,\n];\n\n$headers = [\n \"Authorization: Bearer \" . $apiKey,\n];\n\n$session = curl_init();\ncurl_setopt($session, CURLOPT_URL, $baseUrl . $endpoint . '?' . http_build_query($queryParams));\ncurl_setopt($session, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($session, CURLOPT_HTTPGET, true);\ncurl_setopt($session, CURLOPT_RETURNTRANSFER, true);\n// curl_setopt($session, CURLOPT_SSL_VERIFYPEER, );\n// curl_setopt($session, CURLOPT_SSL_VERIFYHOST, );\n\n$response = curl_exec($session);\n\nif ($response === false) {\n # エラー処理\n echo \"cURL Error: \" . curl_error($session);\n} else {\n # APIからのデータを処理\n var_dump($response);\n}\n\ncurl_close($session);\n"
},
{
"lang": "python",
"label": "Python 3",
"source": "import requests\n\napi_key = ''\n\nurl = f'https://api.test.fincode.jp/v1/customers'\n\n# ヘッダーを設定\nheaders = {\n 'Authorization': f'Bearer {api_key}',\n}\nquery_params = { 'limit': 10 }\n\ntry:\n response = requests.get(url, headers=headers, params=query_params)\n\n # レスポンスの処理\n if response.status_code == 200:\n # APIからのデータを処理\n print(f\"Success: {response.json()}\")\n else:\n # エラーの処理\n print(f\"Error: {response.json()}\")\nexcept requests.RequestException as e:\n # 通信エラーの処理\n print(f\"Request error: {e}\")\n"
},
{
"lang": "ruby",
"label": "Ruby",
"source": "require 'net/http'\nrequire 'uri'\n\nAPI_KEY = ''\nBASE_URL = 'https://api.test.fincode.jp'\n\ndef main\n endpoint = \"/v1/customers\"\n query_params = { limit: 10 }\n\n uri = URI.parse(BASE_URL + endpoint)\n uri.query = URI.encode_www_form(query_params)\n\n http = Net::HTTP.new(uri.host, uri.port)\n http.use_ssl = true\n\n # リクエストの作成\n request = Net::HTTP::Get.new(uri.request_uri)\n request['Authorization'] = \"Bearer #{API_KEY}\"\n\n # リクエストの送信\n response = http.request(request)\n\n case response\n when Net::HTTPSuccess\n puts 'SUCCESS'\n else\n puts 'ERROR'\n end\n\n # レスポンスの表示\n puts response.body\nend\n\nmain\n"
}
]
}
},
"/v1/customers/{id}": {
"get": {
"security": [
{
"Secret-Bearer-Auth": []
},
{
"Public-Bearer-Auth": []
},
{
"Secret-Basic-Auth": []
}
],
"operationId": "retrieveCustomer",
"tags": [
"顧客"
],
"summary": "顧客 取得",
"description": "IDで指定した顧客情報を取得します。\n",
"parameters": [
{
"name": "id",
"in": "path",
"description": "顧客ID",
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/CustomerId_schema"
}
]
},
"required": true
},
{
"name": "Tenant-Shop-Id",
"in": "header",
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/schema"
}
]
},
"description": "※ 顧客情報を共有しないプラットフォームのメインショップのみ指定可\\\nテナントショップID。\\\nこのテナントショップに紐づく顧客のうち、指定したIDの顧客情報を取得します。\n",
"required": false
}
],
"responses": {
"200": {
"description": "リクエストに成功",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Customer.Retrieving.Response"
}
}
}
},
"400": {
"description": "不正なリクエスト",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FincodeAPIError.Response"
}
}
}
}
},
"x-code-samples": [
{
"lang": "curl",
"label": "cURL",
"source": "curl \\\n -X GET \\\n -H \"Authorization:Bearer \" \\\n'https://api.test.fincode.jp/v1/customers/{id}'\n"
},
{
"lang": "node",
"label": "Node.js",
"source": "import { createFincode } from \"@fincode/node\";\n\nconst API_KEY = \"\";\n\n(async () => {\n const fincode = createFincode({ apiKey: API_KEY, isLiveMode: false });\n\n const customerId = \"\";\n\n try {\n // リクエストの送信\n const customer = await fincode.customers.retrieve(customerId);\n } catch (e) {\n // エラーの処理\n }\n})();\n"
},
{
"lang": "go",
"label": "Go",
"source": "package main\n\nimport (\n\t\"fmt\"\n\t\"log\"\n\t\"net/http\"\n)\n\nfunc main() {\n\n\tapiKey := \"\"\n\n\tcustomerID := \"\"\n\n\t// リクエストの作成\n\treq, _ := http.NewRequest(\n\t\t\"GET\",\n\t\tfmt.Sprintf(\"https://api.test.fincode.jp/v1/customers/%s\", customerID),\n\t\tnil,\n\t)\n\treq.Header.Set(\"Authorization\", fmt.Sprintf(\"Bearer %s\", apiKey))\n\n\t// リクエストの送信\n\tclient := &http.Client{}\n\tres, err := client.Do(req)\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\tdefer res.Body.Close()\n\n}\n"
},
{
"lang": "php",
"label": "PHP",
"source": "';\n\n$customerId = '';\n\n$baseUrl = \"https://api.test.fincode.jp\";\n$endpoint = \"/v1/customers/{$customerId}\";\n$headers = [\n \"Authorization: Bearer \" . $apiKey,\n];\n\n$session = curl_init();\ncurl_setopt($session, CURLOPT_URL, $baseUrl . $endpoint);\ncurl_setopt($session, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($session, CURLOPT_HTTPGET, true);\ncurl_setopt($session, CURLOPT_RETURNTRANSFER, true);\n// curl_setopt($session, CURLOPT_SSL_VERIFYPEER, );\n// curl_setopt($session, CURLOPT_SSL_VERIFYHOST, );\n\n$response = curl_exec($session);\n\nif ($response === false) {\n # エラー処理\n echo \"cURL Error: \" . curl_error($session);\n} else {\n # APIからのデータを処理\n var_dump($response);\n}\n\ncurl_close($session);\n"
},
{
"lang": "python",
"label": "Python 3",
"source": "import requests\n\napi_key = ''\n\ncustomer_id = ''\n\nurl = f'https://api.test.fincode.jp/v1/customers/{customer_id}/'\n\n# ヘッダーを設定\nheaders = {\n 'Authorization': f'Bearer {api_key}',\n}\n\ntry:\n response = requests.get(url, headers=headers)\n\n # レスポンスの処理\n if response.status_code == 200:\n # APIからのデータを処理\n print(f\"Success: {response.json()}\")\n else:\n # エラーの処理\n print(f\"Error: {response.json()}\")\nexcept requests.RequestException as e:\n # 通信エラーの処理\n print(f\"Request error: {e}\")\n"
},
{
"lang": "ruby",
"label": "Ruby",
"source": "require 'net/http'\nrequire 'uri'\n\nAPI_KEY = ''\nBASE_URL = 'https://api.test.fincode.jp'\n\ndef main\n customer_id = ''\n endpoint = \"/v1/customers/#{customer_id}\"\n\n uri = URI.parse(BASE_URL + endpoint)\n\n http = Net::HTTP.new(uri.host, uri.port)\n http.use_ssl = true\n\n # リクエストの作成\n request = Net::HTTP::Get.new(uri.request_uri)\n request['Authorization'] = \"Bearer #{API_KEY}\"\n\n # リクエストの送信\n response = http.request(request)\n\n case response\n when Net::HTTPSuccess\n puts 'SUCCESS'\n else\n puts 'ERROR'\n end\n\n # レスポンスの表示\n puts response.body\nend\n\nmain\n"
}
]
},
"put": {
"security": [
{
"Secret-Bearer-Auth": []
},
{
"Secret-Basic-Auth": []
}
],
"operationId": "updateCustomer",
"tags": [
"顧客"
],
"summary": "顧客 更新",
"description": "IDで指定した顧客情報を更新します。\n",
"parameters": [
{
"name": "id",
"in": "path",
"description": "顧客ID",
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/CustomerId_schema"
}
]
},
"required": true
},
{
"in": "header",
"name": "Tenant-Shop-Id",
"required": false,
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/schema"
}
]
},
"description": "※ 顧客情報を共有しないプラットフォームのメインショップのみ指定可\\\nテナントショップID。\\\nこのテナントショップに紐づく顧客のうち、指定したIDの顧客情報を更新します。\n"
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Customer.Updating.Request"
}
}
}
},
"responses": {
"200": {
"description": "リクエストに成功",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Customer.Updating.Response"
}
}
}
},
"400": {
"description": "不正なリクエスト",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FincodeAPIError.Response"
}
}
}
}
},
"x-code-samples": [
{
"lang": "curl",
"label": "cURL",
"source": "curl \\\n -X PUT \\\n -H \"Authorization:Bearer \" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"name\": \"Jane Doe\",\n \"email\": \"jane@example.com\"\n}' \\\n'https://api.test.fincode.jp/v1/customers/{id}'\n"
},
{
"lang": "node",
"label": "Node.js",
"source": "import { createFincode } from \"@fincode/node\";\n\nconst API_KEY = \"\";\n\n(async () => {\n const fincode = createFincode({ apiKey: API_KEY, isLiveMode: false });\n\n const customerId = \"\";\n\n try {\n // リクエストの送信\n const customer = await fincode.customers.update(customerId, {\n name: \"Jane Doe\",\n email: \"jane@example.com\",\n });\n } catch (e) {\n // エラーの処理\n }\n})();\n"
},
{
"lang": "go",
"label": "Go",
"source": "package main\n\nimport (\n\t\"bytes\"\n\t\"encoding/json\"\n\t\"fmt\"\n\t\"log\"\n\t\"net/http\"\n)\n\nfunc main() {\n\n\tapiKey := \"\"\n\n\tcustomerID := \"\"\n\tbody := UpdatingCustomerRequest{\n\t\tName: stringPointer(\"Jane Doe\"),\n\t\tEmail: stringPointer(\"jane@example.com\"),\n\t}\n\n\tmarshalledBody, _ := json.Marshal(body)\n\n\t// リクエストの作成\n\treq, _ := http.NewRequest(\n\t\t\"PUT\",\n\t\tfmt.Sprintf(\"https://api.test.fincode.jp/v1/customers/%s\", customerID),\n\t\tbytes.NewBuffer(marshalledBody),\n\t)\n\treq.Header.Set(\"Authorization\", fmt.Sprintf(\"Bearer %s\", apiKey))\n\treq.Header.Set(\"Content-Type\", \"application/json\")\n\n\t// リクエストの送信\n\tclient := &http.Client{}\n\tres, err := client.Do(req)\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\tdefer res.Body.Close()\n\n}\n\ntype UpdatingCustomerRequest struct {\n\tName *string `json:\"name,omitempty\"`\n\tEmail *string `json:\"email,omitempty\"`\n\tPhoneCC *string `json:\"phone_cc,omitempty\"`\n\tPhoneNo *string `json:\"phone_no,omitempty\"`\n\tAddrCity *string `json:\"addr_city,omitempty\"`\n\tAddrCountry *string `json:\"addr_country,omitempty\"`\n\tAddrLine1 *string `json:\"addr_line_1,omitempty\"`\n\tAddrLine2 *string `json:\"addr_line_2,omitempty\"`\n\tAddrLine3 *string `json:\"addr_line_3,omitempty\"`\n\tAddrPostCode *string `json:\"addr_post_code,omitempty\"`\n\tAddrState *string `json:\"addr_state,omitempty\"`\n}\n\nfunc stringPointer(s string) *string {\n\treturn &s\n}\n"
},
{
"lang": "php",
"label": "PHP",
"source": "';\n\n\n$customerId = '';\n\n$baseUrl = \"https://api.test.fincode.jp\";\n$endpoint = \"/v1/customers/{$customerId}\";\n$headers = [\n \"Authorization: Bearer \" . $apiKey,\n \"Content-Type: application/json\"\n];\n\n$data = json_encode([\n \"name\" => \"Jane Doe\",\n \"email\" => \"jane@example.com\"\n]);\n\n$session = curl_init();\ncurl_setopt($session, CURLOPT_URL, $baseUrl . $endpoint);\ncurl_setopt($session, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($session, CURLOPT_CUSTOMREQUEST, 'PUT');\ncurl_setopt($session, CURLOPT_POSTFIELDS, $data);\ncurl_setopt($session, CURLOPT_RETURNTRANSFER, true);\n// curl_setopt($session, CURLOPT_SSL_VERIFYPEER, );\n// curl_setopt($session, CURLOPT_SSL_VERIFYHOST, );\n\n$response = curl_exec($session);\n\nif ($response === false) {\n # エラー処理\n echo \"cURL Error: \" . curl_error($session);\n} else {\n # APIからのデータを処理\n var_dump($response);\n}\n\ncurl_close($session);\n"
},
{
"lang": "python",
"label": "Python 3",
"source": "import requests\n\napi_key = ''\n\ncustomer_id = ''\n\nurl = f'https://api.test.fincode.jp/v1/customers/{customer_id}/'\n\n# ヘッダーを設定\nheaders = {\n 'Authorization': f'Bearer {api_key}',\n 'Content-Type': 'application/json'\n}\n\ndata = {\n \"name\": \"Jane Doe\",\n \"email\": \"jane@example.com\"\n}\n\n# HTTP POSTリクエストの送信\ntry:\n response = requests.put(url, headers=headers, json=data)\n\n # レスポンスの処理\n if response.status_code == 200:\n # 成功した場合の処理\n print(f\"Success: {response.json()}\")\n else:\n # エラーの処理\n print(f\"Error: {response.json()}\")\nexcept requests.RequestException as e:\n # 通信エラーの処理\n print(f\"Request error: {e}\")\n"
},
{
"lang": "ruby",
"label": "Ruby",
"source": "require 'net/http'\nrequire 'uri'\nrequire 'json'\n\n\nAPI_KEY = ''\nBASE_URL = 'https://api.test.fincode.jp'\n\ndef main\n customer_id = ''\n endpoint = \"/v1/customers/#{customer_id}\"\n uri = URI.parse(BASE_URL + endpoint)\n\n http = Net::HTTP.new(uri.host, uri.port)\n http.use_ssl = true\n\n data = {\n name: 'Jane Doe',\n email: 'jane@example.com',\n }\n\n # リクエストの作成\n request = Net::HTTP::Put.new(uri.request_uri)\n request['Authorization'] = \"Bearer #{API_KEY}\"\n request['Content-Type'] = 'application/json'\n\n request.body = data.to_json\n\n # リクエストの送信\n response = http.request(request)\n\n case response\n when Net::HTTPSuccess\n puts 'SUCCESS'\n else\n puts 'ERROR'\n end\n\n # レスポンスの表示\n puts response.body\nend\n\nmain\n"
}
]
},
"delete": {
"security": [
{
"Secret-Bearer-Auth": []
},
{
"Secret-Basic-Auth": []
}
],
"operationId": "deleteCustomer",
"tags": [
"顧客"
],
"summary": "顧客 削除",
"description": "IDで指定した顧客情報を削除します。\n",
"parameters": [
{
"name": "id",
"in": "path",
"description": "顧客ID",
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/CustomerId_schema"
}
]
},
"required": true
},
{
"name": "Tenant-Shop-Id",
"in": "header",
"required": false,
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/schema"
}
]
},
"description": "※ 顧客情報を共有しないプラットフォームのメインショップのみ指定可\\\nテナントショップID。\\\nこのテナントショップに紐づく顧客のうち、指定したIDの顧客情報を削除します。\n"
}
],
"responses": {
"200": {
"description": "リクエストに成功",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Customer.Deleting.Response"
}
}
}
},
"400": {
"description": "不正なリクエスト",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FincodeAPIError.Response"
}
}
}
}
},
"x-code-samples": [
{
"lang": "curl",
"label": "cURL",
"source": "curl \\\n -X DELETE \\\n -H \"Authorization:Bearer \" \\\n'https://api.test.fincode.jp/v1/customers/{id}'\n"
},
{
"lang": "node",
"label": "Node.js",
"source": "import { createFincode } from \"@fincode/node\";\n\nconst API_KEY = \"\";\n\n(async () => {\n const fincode = createFincode({ apiKey: API_KEY, isLiveMode: false });\n\n const customerId = \"\";\n\n try {\n // リクエストの送信\n const result = await fincode.customers.delete(customerId);\n } catch (e) {\n // エラーの処理\n }\n})();\n"
},
{
"lang": "go",
"label": "Go",
"source": "package main\n\nimport (\n\t\"fmt\"\n\t\"log\"\n\t\"net/http\"\n)\n\nfunc main() {\n\n\tapiKey := \"\"\n\n\tcustomerID := \"\"\n\n\t// リクエストの作成\n\treq, _ := http.NewRequest(\n\t\t\"DELETE\",\n\t\tfmt.Sprintf(\"https://api.test.fincode.jp/v1/customers/%s\", customerID),\n\t\tnil,\n\t)\n\treq.Header.Set(\"Authorization\", fmt.Sprintf(\"Bearer %s\", apiKey))\n\n\t// リクエストの送信\n\tclient := &http.Client{}\n\tres, err := client.Do(req)\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\tdefer res.Body.Close()\n}\n"
},
{
"lang": "php",
"label": "PHP",
"source": "';\n\n$customerId = '';\n\n$baseUrl = \"https://api.test.fincode.jp\";\n$endpoint = \"/v1/customers/{$customerId}\";\n$headers = [\n \"Authorization: Bearer \" . $apiKey,\n];\n\n$session = curl_init();\ncurl_setopt($session, CURLOPT_URL, $baseUrl . $endpoint);\ncurl_setopt($session, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($session, CURLOPT_CUSTOMREQUEST, 'DELETE');\ncurl_setopt($session, CURLOPT_RETURNTRANSFER, true);\n// curl_setopt($session, CURLOPT_SSL_VERIFYPEER, );\n// curl_setopt($session, CURLOPT_SSL_VERIFYHOST, );\n\n$response = curl_exec($session);\n\nif ($response === false) {\n # エラー処理\n echo \"cURL Error: \" . curl_error($session);\n} else {\n # APIからのデータを処理\n var_dump($response);\n}\n\ncurl_close($session);\n"
},
{
"lang": "python",
"label": "Python 3",
"source": "import requests\n\napi_key = ''\n\ncustomer_id = ''\n\nurl = f'https://api.test.fincode.jp/v1/customers/{customer_id}/'\n\n# ヘッダーを設定\nheaders = {\n 'Authorization': f'Bearer {api_key}',\n}\n\ntry:\n response = requests.delete(url, headers=headers)\n\n # レスポンスの処理\n if response.status_code == 200:\n # APIからのデータを処理\n print(f\"Success: {response.json()}\")\n else:\n # エラーの処理\n print(f\"Error: {response.json()}\")\nexcept requests.RequestException as e:\n # 通信エラーの処理\n print(f\"Request error: {e}\")\n"
},
{
"lang": "ruby",
"label": "Ruby",
"source": "require 'net/http'\nrequire 'uri'\n\nAPI_KEY = ''\nBASE_URL = 'https://api.test.fincode.jp'\n\ndef main\n customer_id = ''\n\n endpoint = \"/v1/customers/#{customer_id}\"\n\n uri = URI.parse(BASE_URL + endpoint)\n\n http = Net::HTTP.new(uri.host, uri.port)\n http.use_ssl = true\n\n # リクエストの作成\n request = Net::HTTP::Delete.new(uri.request_uri)\n request['Authorization'] = \"Bearer #{API_KEY}\"\n\n # リクエストの送信\n response = http.request(request)\n\n case response\n when Net::HTTPSuccess\n puts 'SUCCESS'\n else\n puts 'ERROR'\n end\n\n # レスポンスの表示\n puts response.body\nend\n\nmain\n"
}
]
}
},
"/v1/customers/{customer_id}/cards": {
"post": {
"security": [
{
"Secret-Bearer-Auth": []
},
{
"Secret-Basic-Auth": []
}
],
"tags": [
"カード"
],
"operationId": "createCustomerCard",
"summary": "カード 登録",
"description": "`customer_id`で指定した顧客に対しカードを登録します。\n\n※ カードの登録は決済手段API（POST /v1/customers/{customer_id}/payment_methods, pay_type = \"Card\"）でも行えます。新規に実装する場合は、口座振替・銀行振込（バーチャル口座）と同じ形式で扱える決済手段APIの利用を推奨します。\n",
"parameters": [
{
"name": "customer_id",
"in": "path",
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/CustomerId_schema"
}
]
},
"description": "このカードが紐づく顧客のID",
"required": true
},
{
"in": "header",
"name": "Tenant-Shop-Id",
"required": false,
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/schema"
}
]
},
"description": "※ 顧客情報を共有しないプラットフォームのメインショップのみ指定可\\\nテナントショップID。\\\nこのテナントショップに紐づく顧客のうち、指定したIDの顧客に対してカードを登録します。\n"
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CustomerCard.Creating.Request"
}
}
}
},
"responses": {
"200": {
"description": "リクエストに成功",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CustomerCard.Creating.Response"
}
}
}
},
"400": {
"description": "不正なリクエスト",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FincodeAPIError.Response"
}
}
}
}
},
"x-code-samples": [
{
"lang": "curl",
"label": "cURL",
"source": "curl \\\n -X POST \\\n -H \"Authorization:Bearer \" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"default_flag\": \"1\",\n \"token\": \"\"\n}' \\\n'https://api.test.fincode.jp/v1/customers/{customer_id}/cards'\n"
},
{
"lang": "node",
"label": "Node.js",
"source": "import { createFincode } from \"@fincode/node\";\n\nconst API_KEY = \"\";\n\n(async () => {\n const fincode = createFincode({ apiKey: API_KEY, isLiveMode: false });\n\n const customerId = \"\";\n\n try {\n // リクエストの送信\n const card = await fincode.cards.create(customerId, {\n token: \"\",\n default_flag: \"1\",\n });\n } catch (e) {\n // エラーの処理\n }\n})();\n"
},
{
"lang": "go",
"label": "Go",
"source": "package main\n\nimport (\n\t\"bytes\"\n\t\"encoding/json\"\n\t\"fmt\"\n\t\"log\"\n\t\"net/http\"\n)\n\nfunc main() {\n\n\tapiKey := \"\"\n\n\tcustomerID := \"\"\n\n\tbody := CreatingCustomerCardRequest{\n\t\tToken: \"\",\n\t\tDefaultFlag: \"0\",\n\t}\n\n\tmarshalledBody, _ := json.Marshal(body)\n\n\t// リクエストの作成\n\treq, _ := http.NewRequest(\"POST\", fmt.Sprintf(\"https://api.test.fincode.jp/v1/customers/%s/cards\", customerID), bytes.NewBuffer(marshalledBody))\n\treq.Header.Set(\"Authorization\", fmt.Sprintf(\"Bearer %s\", apiKey))\n\treq.Header.Set(\"Content-Type\", \"application/json\")\n\n\t// リクエストの送信\n\tclient := &http.Client{}\n\tres, err := client.Do(req)\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\tdefer res.Body.Close()\n\n}\n\ntype CreatingCustomerCardRequest struct {\n\tDefaultFlag string `json:\"default_flag\"`\n\tToken string `json:\"token\"`\n}\n"
},
{
"lang": "php",
"label": "PHP",
"source": "';\n\n$customerId = '';\n\n$baseUrl = \"https://api.test.fincode.jp\";\n$endpoint = \"/v1/customers/{$customerId}/cards\";\n$headers = [\n \"Authorization: Bearer \" . $apiKey,\n \"Content-Type: application/json\"\n];\n\n$data = json_encode([\n \"token\" => \"613531623566356561366261346366623132306663393139\",\n \"default_flag\" => \"1\"\n]);\n\n$session = curl_init();\ncurl_setopt($session, CURLOPT_URL, $baseUrl . $endpoint);\ncurl_setopt($session, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($session, CURLOPT_POST, true);\ncurl_setopt($session, CURLOPT_POSTFIELDS, $data);\ncurl_setopt($session, CURLOPT_RETURNTRANSFER, true);\n// curl_setopt($session, CURLOPT_SSL_VERIFYPEER, );\n// curl_setopt($session, CURLOPT_SSL_VERIFYHOST, );\n\n$response = curl_exec($session);\n\nif ($response === false) {\n # エラー処理\n echo \"cURL Error: \" . curl_error($session);\n} else {\n # APIからのデータを処理\n var_dump($response);\n}\n\ncurl_close($session);\n"
},
{
"lang": "python",
"label": "Python 3",
"source": "import requests\n\napi_key = ''\n\ncustomer_id = ''\n\nurl = f'https://api.test.fincode.jp/v1/customers/{customer_id}/cards'\n\n# ヘッダーを設定\nheaders = {\n 'Authorization': f'Bearer {api_key}',\n 'Content-Type': 'application/json'\n}\n\ndata = {\n \"token\": \"\",\n \"default_flag\": \"1\",\n}\n\n# HTTP POSTリクエストの送信\ntry:\n response = requests.post(url, headers=headers, json=data)\n\n # レスポンスの処理\n if response.status_code == 200:\n # 成功した場合の処理\n print(f\"Success: {response.json()}\")\n else:\n # エラーの処理\n print(f\"Error: {response.json()}\")\nexcept requests.RequestException as e:\n # 通信エラーの処理\n print(f\"Request error: {e}\")\n"
},
{
"lang": "ruby",
"label": "Ruby",
"source": "require 'net/http'\nrequire 'uri'\nrequire 'json'\n\n\nAPI_KEY = ''\nBASE_URL = 'https://api.test.fincode.jp'\n\ndef main\n customer_id = ''\n endpoint = \"/v1/customers/#{customer_id}/cards\"\n uri = URI.parse(BASE_URL + endpoint)\n\n http = Net::HTTP.new(uri.host, uri.port)\n http.use_ssl = true\n\n data = {\n token: '',\n default_flag: '1'\n }\n\n # リクエストの作成\n request = Net::HTTP::Post.new(uri.request_uri)\n request['Authorization'] = \"Bearer #{API_KEY}\"\n request['Content-Type'] = 'application/json'\n\n request.body = data.to_json\n\n # リクエストの送信\n response = http.request(request)\n\n case response\n when Net::HTTPSuccess\n puts 'SUCCESS'\n else\n puts 'ERROR'\n end\n\n # レスポンスの表示\n puts response.body\nend\n\nmain\n"
}
]
},
"get": {
"security": [
{
"Secret-Bearer-Auth": []
},
{
"Public-Bearer-Auth": []
},
{
"Secret-Basic-Auth": []
}
],
"tags": [
"カード"
],
"operationId": "retrieveCustomerCardList",
"summary": "カード 一覧取得",
"description": "`customer_id`で指定した顧客に対し紐づくカードを一覧で取得します。\n\n※ カード情報の一覧は決済手段API（GET /v1/customers/{customer_id}/payment_methods, pay_type = \"Card\"）でも取得できます。新規に実装する場合は決済手段APIの利用を推奨します。\n",
"parameters": [
{
"name": "customer_id",
"in": "path",
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/CustomerId_schema"
}
]
},
"description": "顧客ID。 \\\nこの顧客に紐づくカードを一覧で取得します。\n",
"required": true
},
{
"in": "header",
"name": "Tenant-Shop-Id",
"required": false,
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/schema"
}
]
},
"description": "※ 顧客情報を共有しないプラットフォームのメインショップのみ指定可\\\nテナントショップID。\\\nこのテナントショップに紐づく顧客のうち、指定したIDの顧客に対して登録されたカードの一覧を取得します。\n"
}
],
"responses": {
"200": {
"description": "リクエストに成功",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CustomerCard.ListRetrieving.Response"
}
}
}
},
"400": {
"description": "不正なリクエスト",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FincodeAPIError.Response"
}
}
}
}
},
"x-code-samples": [
{
"lang": "curl",
"label": "cURL",
"source": "curl \\\n -X GET \\\n -H \"Authorization:Bearer \" \\\n'https://api.test.fincode.jp/v1/customers/{customer_id}/cards'\n"
},
{
"lang": "node",
"label": "Node.js",
"source": "import { createFincode } from \"@fincode/node\";\n\nconst API_KEY = \"\";\n\n(async () => {\n const fincode = createFincode({ apiKey: API_KEY, isLiveMode: false });\n\n const customerId = \"\";\n\n try {\n // リクエストの送信\n const cards = await fincode.cards.retrieveList(customerId);\n } catch (e) {\n // エラーの処理\n }\n})();\n"
},
{
"lang": "go",
"label": "Go",
"source": "package main\n\nimport (\n\t\"fmt\"\n\t\"log\"\n\t\"net/http\"\n)\n\nfunc main() {\n\n\tapiKey := \"\"\n\n\tcustomerID := \"\"\n\n\t// リクエストの作成\n\treq, _ := http.NewRequest(\"GET\", fmt.Sprintf(\"https://api.test.fincode.jp/v1/customers/%s/cards\", customerID), nil)\n\treq.Header.Set(\"Authorization\", fmt.Sprintf(\"Bearer %s\", apiKey))\n\n\t// リクエストの送信\n\tclient := &http.Client{}\n\tres, err := client.Do(req)\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\tdefer res.Body.Close()\n\n}\n"
},
{
"lang": "php",
"label": "PHP",
"source": "';\n\n$customerId = '';\n\n$baseUrl = \"https://api.test.fincode.jp\";\n$endpoint = \"/v1/customers/{$customerId}/cards\";\n$headers = [\n \"Authorization: Bearer \" . $apiKey,\n];\n\n$session = curl_init();\ncurl_setopt($session, CURLOPT_URL, $baseUrl . $endpoint);\ncurl_setopt($session, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($session, CURLOPT_HTTPGET, true);\ncurl_setopt($session, CURLOPT_RETURNTRANSFER, true);\n// curl_setopt($session, CURLOPT_SSL_VERIFYPEER, );\n// curl_setopt($session, CURLOPT_SSL_VERIFYHOST, );\n\n$response = curl_exec($session);\n\nif ($response === false) {\n # エラー処理\n echo \"cURL Error: \" . curl_error($session);\n} else {\n # APIからのデータを処理\n var_dump($response);\n}\n\ncurl_close($session);\n"
},
{
"lang": "python",
"label": "Python 3",
"source": "from calendar import c\nimport requests\n\napi_key = ''\n\ncustomer_id = ''\n\nurl = f'https://api.test.fincode.jp/v1/customers/{customer_id}/cards'\n\n# ヘッダーを設定\nheaders = {\n 'Authorization': f'Bearer {api_key}',\n}\n\ntry:\n response = requests.get(url, headers=headers)\n\n # レスポンスの処理\n if response.status_code == 200:\n # APIからのデータを処理\n print(f\"Success: {response.json()}\")\n else:\n # エラーの処理\n print(f\"Error: {response.json()}\")\nexcept requests.RequestException as e:\n # 通信エラーの処理\n print(f\"Request error: {e}\")\n"
},
{
"lang": "ruby",
"label": "Ruby",
"source": "require 'net/http'\nrequire 'uri'\n\nAPI_KEY = ''\nBASE_URL = 'https://api.test.fincode.jp'\n\ndef main\n customer_id = ''\n endpoint = \"/v1/customers/#{customer_id}/cards\"\n\n uri = URI.parse(BASE_URL + endpoint)\n uri.query = URI.encode_www_form(query_params)\n\n http = Net::HTTP.new(uri.host, uri.port)\n http.use_ssl = true\n\n # リクエストの作成\n request = Net::HTTP::Get.new(uri.request_uri)\n request['Authorization'] = \"Bearer #{API_KEY}\"\n\n # リクエストの送信\n response = http.request(request)\n\n case response\n when Net::HTTPSuccess\n puts 'SUCCESS'\n else\n puts 'ERROR'\n end\n\n # レスポンスの表示\n puts response.body\nend\n\nmain\n"
}
]
}
},
"/v1/customers/{customer_id}/cards/{id}": {
"get": {
"security": [
{
"Secret-Bearer-Auth": []
},
{
"Public-Bearer-Auth": []
},
{
"Secret-Basic-Auth": []
}
],
"tags": [
"カード"
],
"operationId": "retrieveCustomerCard",
"summary": "カード 取得",
"description": "`customer_id`で指定した顧客に対し紐づくカードのうち`id`で指定したものを取得します。\n\n※ カード情報の取得は決済手段API（GET /v1/customers/{customer_id}/payment_methods/{id}, pay_type = \"Card\"）でも行えます。新規に実装する場合は決済手段APIの利用を推奨します。\n",
"parameters": [
{
"name": "customer_id",
"in": "path",
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/CustomerId_schema"
}
]
},
"description": "このカードが紐づく顧客のID",
"required": true
},
{
"name": "id",
"in": "path",
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/CardId_schema"
}
]
},
"description": "取得するカードのID",
"required": true
},
{
"in": "header",
"name": "Tenant-Shop-Id",
"required": false,
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/schema"
}
]
},
"description": "※ 顧客情報を共有しないプラットフォームのメインショップのみ指定可\\\nテナントショップID。\\\nこのテナントショップに紐づく顧客のうち、指定したIDの顧客に対して登録されたカードから取得します。\n"
}
],
"responses": {
"200": {
"description": "リクエストに成功",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CustomerCard.Retrieving.Response"
}
}
}
},
"400": {
"description": "不正なリクエスト",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FincodeAPIError.Response"
}
}
}
}
},
"x-code-samples": [
{
"lang": "curl",
"label": "cURL",
"source": "curl \\\n -X GET \\\n -H \"Authorization:Bearer \" \\\n'https://api.test.fincode.jp/v1/customers/{customer_id}/cards/{id}'\n"
},
{
"lang": "node",
"label": "Node.js",
"source": "import { createFincode } from \"@fincode/node\";\n\nconst API_KEY = \"\";\n\n(async () => {\n const fincode = createFincode({ apiKey: API_KEY, isLiveMode: false });\n\n const customerId = \"\";\n const cardId = \"\";\n\n try {\n // リクエストの送信\n const card = await fincode.cards.retrieve(customerId, cardId);\n } catch (e) {\n // エラーの処理\n }\n})();\n"
},
{
"lang": "go",
"label": "Go",
"source": "package main\n\nimport (\n\t\"fmt\"\n\t\"log\"\n\t\"net/http\"\n)\n\nfunc main() {\n\n\tapiKey := \"\"\n\n\tcustomerID := \"\"\n\tcardID := \"\"\n\n\t// リクエストの作成\n\treq, _ := http.NewRequest(\n\t\t\"GET\",\n\t\tfmt.Sprintf(\"https://api.test.fincode.jp/v1/customers/%s/cards/%s\", customerID, cardID),\n\t\tnil,\n\t)\n\treq.Header.Set(\"Authorization\", fmt.Sprintf(\"Bearer %s\", apiKey))\n\n\t// リクエストの送信\n\tclient := &http.Client{}\n\tres, err := client.Do(req)\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\tdefer res.Body.Close()\n\n}\n"
},
{
"lang": "php",
"label": "PHP",
"source": "';\n\n$customerId = '';\n$cardId = '';\n\n$baseUrl = \"https://api.test.fincode.jp\";\n$endpoint = \"/v1/customers/{$customerId}/cards/{$cardId}\";\n$headers = [\n \"Authorization: Bearer \" . $apiKey,\n];\n\n$session = curl_init();\ncurl_setopt($session, CURLOPT_URL, $baseUrl . $endpoint);\ncurl_setopt($session, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($session, CURLOPT_HTTPGET, true);\ncurl_setopt($session, CURLOPT_RETURNTRANSFER, true);\n// curl_setopt($session, CURLOPT_SSL_VERIFYPEER, );\n// curl_setopt($session, CURLOPT_SSL_VERIFYHOST, );\n\n$response = curl_exec($session);\n\nif ($response === false) {\n # エラー処理\n echo \"cURL Error: \" . curl_error($session);\n} else {\n # APIからのデータを処理\n var_dump($response);\n}\n\ncurl_close($session);\n"
},
{
"lang": "python",
"label": "Python 3",
"source": "import requests\n\napi_key = ''\n\ncustomer_id = ''\ncard_id = ''\n\nurl = f'https://api.test.fincode.jp/v1/customers/{customer_id}/cards/{card_id}/'\n\n# ヘッダーを設定\nheaders = {\n 'Authorization': f'Bearer {api_key}',\n}\n\ntry:\n response = requests.get(url, headers=headers)\n\n # レスポンスの処理\n if response.status_code == 200:\n # APIからのデータを処理\n print(f\"Success: {response.json()}\")\n else:\n # エラーの処理\n print(f\"Error: {response.json()}\")\nexcept requests.RequestException as e:\n # 通信エラーの処理\n print(f\"Request error: {e}\")\n"
},
{
"lang": "ruby",
"label": "Ruby",
"source": "require 'net/http'\nrequire 'uri'\n\nAPI_KEY = ''\nBASE_URL = 'https://api.test.fincode.jp'\n\ndef main\n customer_id = ''\n card_id = ''\n \n endpoint = \"/v1/customers/#{customer_id}/cards/#{card_id}\"\n\n uri = URI.parse(BASE_URL + endpoint)\n\n http = Net::HTTP.new(uri.host, uri.port)\n http.use_ssl = true\n\n # リクエストの作成\n request = Net::HTTP::Get.new(uri.request_uri)\n request['Authorization'] = \"Bearer #{API_KEY}\"\n\n # リクエストの送信\n response = http.request(request)\n\n case response\n when Net::HTTPSuccess\n puts 'SUCCESS'\n else\n puts 'ERROR'\n end\n\n # レスポンスの表示\n puts response.body\nend\n\nmain\n"
}
]
},
"put": {
"security": [
{
"Secret-Bearer-Auth": []
},
{
"Secret-Basic-Auth": []
}
],
"tags": [
"カード"
],
"operationId": "updateCustomerCard",
"summary": "カード 更新",
"description": "`customer_id`で指定した顧客に対し紐づくカードのうち`id`で指定したものを更新します。\n\n※ カード情報の更新は決済手段API（PUT /v1/customers/{customer_id}/payment_methods/{id}, pay_type = \"Card\"）でも行えます。新規に実装する場合は決済手段APIの利用を推奨します。\n",
"parameters": [
{
"name": "customer_id",
"in": "path",
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/CustomerId_schema"
}
]
},
"description": "このカードが紐づく顧客のID",
"required": true
},
{
"name": "id",
"in": "path",
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/CardId_schema"
}
]
},
"description": "更新するカードのID",
"required": true
},
{
"in": "header",
"name": "Tenant-Shop-Id",
"required": false,
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/schema"
}
]
},
"description": "※ 顧客情報を共有しないプラットフォームのメインショップのみ指定可\\\nテナントショップID。\\\nこのテナントショップに紐づく顧客のうち、指定したIDの顧客に対して登録されたカードの情報を更新します。\n"
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CustomerCard.Updating.Request"
}
}
}
},
"responses": {
"200": {
"description": "リクエストに成功",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CustomerCard.Updating.Response"
}
}
}
},
"400": {
"description": "不正なリクエスト",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FincodeAPIError.Response"
}
}
}
}
},
"x-code-samples": [
{
"lang": "curl",
"label": "cURL",
"source": "curl \\\n -X PUT \\\n -H \"Authorization:Bearer \" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"default_flag\": \"1\",\n}' \\\n'https://api.test.fincode.jp/v1/customers/{customer_id}/cards/{id}'\n"
},
{
"lang": "node",
"label": "Node.js",
"source": "import { createFincode } from \"@fincode/node\";\n\nconst API_KEY = \"\";\n\n(async () => {\n const fincode = createFincode({ apiKey: API_KEY, isLiveMode: false });\n\n const customerId = \"\";\n const cardId = \"\";\n\n try {\n // リクエストの送信\n const card = await fincode.cards.update(customerId, cardId, {\n default_flag: \"0\",\n });\n } catch (e) {\n // エラーの処理\n }\n})();\n"
},
{
"lang": "go",
"label": "Go",
"source": "package main\n\nimport (\n\t\"bytes\"\n\t\"encoding/json\"\n\t\"fmt\"\n\t\"log\"\n\t\"net/http\"\n)\n\nfunc main() {\n\n\tapiKey := \"\"\n\n\tbody := UpdatingCustomerCardRequest{\n\t\tDefaultFlag: stringPointer(\"1\"),\n\t}\n\n\tmarshalledBody, _ := json.Marshal(body)\n\n\t// リクエストの作成\n\treq, _ := http.NewRequest(\"PUT\", \"https://api.test.fincode.jp/v1/customers/{customer_id}/cards/{id}\", bytes.NewBuffer(marshalledBody))\n\treq.Header.Set(\"Authorization\", fmt.Sprintf(\"Bearer %s\", apiKey))\n\treq.Header.Set(\"Content-Type\", \"application/json\")\n\n\t// リクエストの送信\n\tclient := &http.Client{}\n\tres, err := client.Do(req)\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\tdefer res.Body.Close()\n\n}\n\ntype UpdatingCustomerCardRequest struct {\n\tDefaultFlag *string `json:\"default_flag,omitempty\"`\n\tToken *string `json:\"token,omitempty\"`\n\tHolderName *string `json:\"holder_name,omitempty\"`\n\tExpire *string `json:\"expire,omitempty\"`\n}\n\nfunc stringPointer(s string) *string {\n\treturn &s\n}\n"
},
{
"lang": "php",
"label": "PHP",
"source": "';\n\n$customerId = '';\n$cardId = '';\n\n$baseUrl = \"https://api.test.fincode.jp\";\n$endpoint = \"/v1/customers/{$customerId}/cards/{$cardId}\";\n$headers = [\n \"Authorization: Bearer \" . $apiKey,\n];\n\n$data = json_encode([\n \"default_flag\" => \"0\"\n]);\n\n$session = curl_init();\ncurl_setopt($session, CURLOPT_URL, $baseUrl . $endpoint);\ncurl_setopt($session, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($session, CURLOPT_CUSTOMREQUEST, 'PUT');\ncurl_setopt($session, CURLOPT_POSTFIELDS, $data);\ncurl_setopt($session, CURLOPT_RETURNTRANSFER, true);\n// curl_setopt($session, CURLOPT_SSL_VERIFYPEER, );\n// curl_setopt($session, CURLOPT_SSL_VERIFYHOST, );\n\n$response = curl_exec($session);\n\nif ($response === false) {\n # エラー処理\n echo \"cURL Error: \" . curl_error($session);\n} else {\n # APIからのデータを処理\n var_dump($response);\n}\n\ncurl_close($session);\n"
},
{
"lang": "python",
"label": "Python 3",
"source": "import requests\n\napi_key = ''\n\ncustomer_id = ''\ncard_id = ''\n\nurl = f'https://api.test.fincode.jp/v1/customers/{customer_id}/cards/{card_id}/'\n\n# ヘッダーを設定\nheaders = {\n 'Authorization': f'Bearer {api_key}',\n 'Content-Type': 'application/json'\n}\n\ndata = {\n \"default_flag\": \"0\",\n}\n\n# HTTP POSTリクエストの送信\ntry:\n response = requests.put(url, headers=headers, json=data)\n\n # レスポンスの処理\n if response.status_code == 200:\n # 成功した場合の処理\n print(f\"Success: {response.json()}\")\n else:\n # エラーの処理\n print(f\"Error: {response.json()}\")\nexcept requests.RequestException as e:\n # 通信エラーの処理\n print(f\"Request error: {e}\")\n"
},
{
"lang": "ruby",
"label": "Ruby",
"source": "require 'net/http'\nrequire 'uri'\nrequire 'json'\n\n\nAPI_KEY = ''\nBASE_URL = 'https://api.test.fincode.jp'\n\ndef main\n customer_id = ''\n card_id = ''\n\n endpoint = \"/v1/customers/#{customer_id}/cards/#{card_id}\"\n uri = URI.parse(BASE_URL + endpoint)\n\n http = Net::HTTP.new(uri.host, uri.port)\n http.use_ssl = true\n\n data = {\n default_flag: '0'\n }\n\n # リクエストの作成\n request = Net::HTTP::Put.new(uri.request_uri)\n request['Authorization'] = \"Bearer #{API_KEY}\"\n request['Content-Type'] = 'application/json'\n\n request.body = data.to_json\n\n # リクエストの送信\n response = http.request(request)\n\n case response\n when Net::HTTPSuccess\n puts 'SUCCESS'\n else\n puts 'ERROR'\n end\n\n # レスポンスの表示\n puts response.body\nend\n\nmain\n"
}
]
},
"delete": {
"tags": [
"カード"
],
"operationId": "deleteCustomerCard",
"summary": "カード 削除",
"description": "`customer_id`で指定した顧客に対し紐づくカードのうち`id`で指定したものを削除します。\n\n※ カード情報の削除は決済手段API（DELETE /v1/customers/{customer_id}/payment_methods/{id}, pay_type = \"Card\"）でも行えます。新規に実装する場合は決済手段APIの利用を推奨します。\n",
"parameters": [
{
"name": "customer_id",
"in": "path",
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/CustomerId_schema"
}
]
},
"description": "このカードが紐づく顧客のID",
"required": true
},
{
"name": "id",
"in": "path",
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/CardId_schema"
}
]
},
"description": "削除するカードのID",
"required": true
},
{
"in": "header",
"name": "Tenant-Shop-Id",
"required": false,
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/schema"
}
]
},
"description": "※ 顧客情報を共有しないプラットフォームのメインショップのみ指定可\\\nテナントショップID。\\\nこのテナントショップに紐づく顧客のうち、指定したIDの顧客に対して登録されたカードを削除します。\n"
}
],
"responses": {
"200": {
"description": "リクエストに成功",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CustomerCard.Deleting.Response"
}
}
}
},
"400": {
"description": "不正なリクエスト",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FincodeAPIError.Response"
}
}
}
}
},
"x-code-samples": [
{
"lang": "curl",
"label": "cURL",
"source": "curl \\\n -X DELETE \\\n -H \"Authorization:Bearer \" \\\n'https://api.test.fincode.jp/v1/customers/{customer_id}/cards/{id}'\n"
},
{
"lang": "node",
"label": "Node.js",
"source": "import { createFincode } from \"@fincode/node\";\n\nconst API_KEY = \"\";\n\n(async () => {\n const fincode = createFincode({ apiKey: API_KEY, isLiveMode: false });\n\n const customerId = \"\";\n const cardId = \"\";\n\n try {\n // リクエストの送信\n const result = await fincode.cards.delete(customerId, cardId);\n } catch (e) {\n // エラーの処理\n }\n})();\n"
},
{
"lang": "go",
"label": "Go",
"source": "package main\n\nimport (\n\t\"fmt\"\n\t\"log\"\n\t\"net/http\"\n)\n\nfunc main() {\n\n\tapiKey := \"\"\n\n\tcustomerID := \"\"\n\tcardID := \"\"\n\n\t// リクエストの作成\n\treq, _ := http.NewRequest(\n\t\t\"DELETE\",\n\t\tfmt.Sprintf(\"https://api.test.fincode.jp/v1/customers/%s/cards/%s\", customerID, cardID),\n\t\tnil,\n\t)\n\treq.Header.Set(\"Authorization\", fmt.Sprintf(\"Bearer %s\", apiKey))\n\n\t// リクエストの送信\n\tclient := &http.Client{}\n\tres, err := client.Do(req)\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\tdefer res.Body.Close()\n}\n"
},
{
"lang": "php",
"label": "PHP",
"source": "';\n\n$customerId = '';\n$cardId = '';\n\n$baseUrl = \"https://api.test.fincode.jp\";\n$endpoint = \"/v1/customers/{$customerId}/cards/{$cardId}\";\n$headers = [\n \"Authorization: Bearer \" . $apiKey,\n];\n\n$session = curl_init();\ncurl_setopt($session, CURLOPT_URL, $baseUrl . $endpoint);\ncurl_setopt($session, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($session, CURLOPT_CUSTOMREQUEST, 'DELETE');\ncurl_setopt($session, CURLOPT_RETURNTRANSFER, true);\n// curl_setopt($session, CURLOPT_SSL_VERIFYPEER, );\n// curl_setopt($session, CURLOPT_SSL_VERIFYHOST, );\n\n$response = curl_exec($session);\n\nif ($response === false) {\n # エラー処理\n echo \"cURL Error: \" . curl_error($session);\n} else {\n # APIからのデータを処理\n var_dump($response);\n}\n\ncurl_close($session);\n"
},
{
"lang": "python",
"label": "Python 3",
"source": "import requests\n\napi_key = ''\n\ncustomer_id = ''\ncard_id = '' \n\nurl = f'https://api.test.fincode.jp/v1/customers/{customer_id}/cards/{card_id}/'\n\n# ヘッダーを設定\nheaders = {\n 'Authorization': f'Bearer {api_key}',\n}\n\ntry:\n response = requests.delete(url, headers=headers)\n\n # レスポンスの処理\n if response.status_code == 200:\n # APIからのデータを処理\n print(f\"Success: {response.json()}\")\n else:\n # エラーの処理\n print(f\"Error: {response.json()}\")\nexcept requests.RequestException as e:\n # 通信エラーの処理\n print(f\"Request error: {e}\")\n"
},
{
"lang": "ruby",
"label": "Ruby",
"source": "require 'net/http'\nrequire 'uri'\n\nAPI_KEY = ''\nBASE_URL = 'https://api.test.fincode.jp'\n\ndef main\n customer_id = ''\n card_id = ''\n\n endpoint = \"/v1/customers/#{customer_id}/cards/#{card_id}\"\n\n uri = URI.parse(BASE_URL + endpoint)\n uri.query = URI.encode_www_form(query_params)\n\n http = Net::HTTP.new(uri.host, uri.port)\n http.use_ssl = true\n\n # リクエストの作成\n request = Net::HTTP::Delete.new(uri.request_uri)\n request['Authorization'] = \"Bearer #{API_KEY}\"\n\n # リクエストの送信\n response = http.request(request)\n\n case response\n when Net::HTTPSuccess\n puts 'SUCCESS'\n else\n puts 'ERROR'\n end\n\n # レスポンスの表示\n puts response.body\nend\n\nmain\n"
}
]
}
},
"/v1/cards": {
"get": {
"security": [
{
"Secret-Bearer-Auth": []
},
{
"Secret-Basic-Auth": []
}
],
"tags": [
"カード"
],
"operationId": "retrieveCardList",
"summary": "カード 一覧取得（顧客情報共有グループ単位）",
"description": "顧客情報共有グループ単位でカード情報を一覧取得する API\n",
"parameters": [
{
"in": "query",
"name": "クエリ",
"description": "カード情報の一覧取得において検索条件となるクエリパラメータ\n",
"required": false,
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/Pagination.QueryParams"
},
{
"$ref": "#/components/schemas/Card.ListRetrieving.QueryParams"
}
]
}
},
{
"in": "header",
"name": "Tenant-Shop-Id",
"required": false,
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/schema"
}
]
},
"description": "※ 顧客情報を共有しないプラットフォームのメインショップのみ指定可\\\nテナントショップID。\\\nこのテナントショップに紐づく顧客情報共有グループのカード情報から一覧で取得します。\n"
}
],
"responses": {
"200": {
"description": "リクエストに成功",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Card.ListRetrieving.Response"
}
}
}
},
"400": {
"description": "不正なリクエスト",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FincodeAPIError.Response"
}
}
}
}
},
"x-code-samples": [
{
"lang": "curl",
"label": "cURL",
"source": "curl \\\n -X GET \\\n -H \"Authorization:Bearer \" \\\n'https://api.test.fincode.jp/v1/cards?limit=10&page=1&customer_id='\n"
},
{
"lang": "node",
"label": "Node.js",
"source": "import fetch from \"node-fetch\";\n\nconst BASE_URL = \"https://api.test.fincode.jp\";\n\nconst API_KEY = \"\";\n\n(async () => {\n const endpoint = new URL(`${BASE_URL}/v1/cards`);\n endpoint.search = new URLSearchParams({\n limit: \"10\",\n page: \"1\",\n customer_id: \"\",\n }).toString();\n\n const response = await fetch(endpoint, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${API_KEY}`,\n },\n });\n const cards = await response.json();\n})();\n"
},
{
"lang": "go",
"label": "Go",
"source": "package main\n\nimport (\n\t\"fmt\"\n\t\"log\"\n\t\"net/http\"\n)\n\nfunc main() {\n\n\tapiKey := \"\"\n\n\t// リクエストの作成\n\treq, _ := http.NewRequest(\"GET\", \"https://api.test.fincode.jp/v1/cards\", nil)\n\treq.Header.Set(\"Authorization\", fmt.Sprintf(\"Bearer %s\", apiKey))\n\n\tparams := req.URL.Query()\n\tparams.Add(\"limit\", \"10\")\n\tparams.Add(\"page\", \"1\")\n\tparams.Add(\"customer_id\", \"\")\n\treq.URL.RawQuery = params.Encode()\n\n\t// リクエストの送信\n\tclient := &http.Client{}\n\tres, err := client.Do(req)\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\tdefer res.Body.Close()\n\n}\n"
},
{
"lang": "php",
"label": "PHP",
"source": "';\n\n$baseUrl = \"https://api.test.fincode.jp\";\n$endpoint = \"/v1/cards\";\n$queryParams = [\n \"limit\" => 10,\n \"page\" => 1,\n \"customer_id\" => '',\n];\n\n$headers = [\n \"Authorization: Bearer \" . $apiKey,\n];\n\n$session = curl_init();\ncurl_setopt($session, CURLOPT_URL, $baseUrl . $endpoint . '?' . http_build_query($queryParams));\ncurl_setopt($session, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($session, CURLOPT_HTTPGET, true);\ncurl_setopt($session, CURLOPT_RETURNTRANSFER, true);\n// curl_setopt($session, CURLOPT_SSL_VERIFYPEER, );\n// curl_setopt($session, CURLOPT_SSL_VERIFYHOST, );\n\n$response = curl_exec($session);\n\nif ($response === false) {\n # エラー処理\n echo \"cURL Error: \" . curl_error($session);\n} else {\n # APIからのデータを処理\n var_dump($response);\n}\n\ncurl_close($session);\n"
},
{
"lang": "python",
"label": "Python 3",
"source": "import requests\n\napi_key = ''\n\nurl = f'https://api.test.fincode.jp/v1/cards'\n\n# ヘッダーを設定\nheaders = {\n 'Authorization': f'Bearer {api_key}',\n}\nquery_params = {\n 'limit': 10,\n 'page': 1,\n 'customer_id': '',\n}\n\ntry:\n response = requests.get(url, headers=headers, params=query_params)\n\n # レスポンスの処理\n if response.status_code == 200:\n # APIからのデータを処理\n print(f\"Success: {response.json()}\")\n else:\n # エラーの処理\n print(f\"Error: {response.json()}\")\nexcept requests.RequestException as e:\n # 通信エラーの処理\n print(f\"Request error: {e}\")\n"
},
{
"lang": "ruby",
"label": "Ruby",
"source": "require 'net/http'\nrequire 'uri'\n\nAPI_KEY = ''\nBASE_URL = 'https://api.test.fincode.jp'\n\ndef main\n endpoint = \"/v1/cards\"\n query_params = {\n limit: 10,\n page: 1,\n customer_id: ''\n }\n\n uri = URI.parse(BASE_URL + endpoint)\n uri.query = URI.encode_www_form(query_params)\n\n http = Net::HTTP.new(uri.host, uri.port)\n http.use_ssl = true\n\n # リクエストの作成\n request = Net::HTTP::Get.new(uri.request_uri)\n request['Authorization'] = \"Bearer #{API_KEY}\"\n\n # リクエストの送信\n response = http.request(request)\n\n case response\n when Net::HTTPSuccess\n puts 'SUCCESS'\n else\n puts 'ERROR'\n end\n\n # レスポンスの表示\n puts response.body\nend\n\nmain\n"
}
]
}
},
"/v1/customers/{customer_id}/payment_methods": {
"post": {
"security": [
{
"Secret-Bearer-Auth": []
},
{
"Public-Bearer-Auth": []
},
{
"Secret-Basic-Auth": []
}
],
"operationId": "createCustomerPaymentMethod",
"tags": [
"決済手段"
],
"summary": "決済手段 登録",
"description": "`customer_id`で指定した顧客に対し、決済手段を登録します。\n",
"parameters": [
{
"name": "customer_id",
"in": "path",
"description": "顧客ID",
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/CustomerId_schema"
}
]
},
"required": true
},
{
"name": "Tenant-Shop-Id",
"in": "header",
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/schema"
}
]
},
"description": "※ 顧客情報を共有しないプラットフォームのメインショップのみ指定可\\\nテナントショップID。\\\nこのテナントショップに紐づく顧客のうち、指定したIDの顧客に対して決済手段を登録します。\n"
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CustomerPaymentMethod.Creating.Request"
}
}
}
},
"responses": {
"200": {
"description": "リクエストに成功",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CustomerPaymentMethod.Creating.Response"
}
}
}
},
"400": {
"description": "不正なリクエスト",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FincodeAPIError.Response"
}
}
}
}
},
"x-code-samples": [
{
"lang": "curl",
"label": "cURL",
"source": "curl \\\n -X POST \\\n -H \"Authorization:Bearer \" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"pay_type\": \"Directdebit\",\n \"default_flag\": \"1\",\n \"return_url\": \"https://your-service.example.com/return\",\n \"directdebit\": {\n \"application_type\": \"ONLINE\",\n \"bank_code\": \"0310\",\n \"branch_code\": \"000\",\n \"account_type\": \"1\",\n \"account_number\": \"0999999\",\n \"account_name_kana\": \"ナマエカナ\"\n }\n}' \\\n'https://api.test.fincode.jp/v1/customers/{customer_id}/payment_methods'\n"
},
{
"lang": "go",
"label": "Go",
"source": "package main\n\nimport (\n\t\"bytes\"\n\t\"encoding/json\"\n\t\"fmt\"\n\t\"log\"\n\t\"net/http\"\n)\n\nfunc main() {\n\n\tapiKey := \"\"\n\n\tcustomerID := \"\"\n\n\tbody := CreatingPaymentMethodRequest{\n\t\tPayType: \"Directdebit\",\n\t\tDefaultFlag: \"1\",\n\t\tReturnURL: \"https://your-service.example.com/return\",\n\t\tDirectdebit: Directdebit{\n\t\t\tApplicationType: \"ONLINE\",\n\t\t\tBankCode: \"0310\",\n\t\t\tBranchCode: stringPointer(\"000\"),\n\t\t\tAccountType: stringPointer(\"1\"),\n\t\t\tAccountNumber: stringPointer(\"0999999\"),\n\t\t\tAccountNameKana: \"ナマエカナ\",\n\t\t},\n\t}\n\n\tmarshalledBody, _ := json.Marshal(body)\n\n\turl := fmt.Sprintf(\"https://api.test.fincode.jp/v1/customers/%s/payment_methods\", customerID)\n\n\t// リクエストの作成\n\treq, _ := http.NewRequest(\n\t\t\"POST\",\n\t\turl,\n\t\tbytes.NewBuffer(marshalledBody),\n\t)\n\treq.Header.Set(\"Authorization\", fmt.Sprintf(\"Bearer %s\", apiKey))\n\treq.Header.Set(\"Content-Type\", \"application/json\")\n\n\t// リクエストの送信\n\tclient := &http.Client{}\n\tres, err := client.Do(req)\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\tdefer res.Body.Close()\n\n}\n\ntype CreatingPaymentMethodRequest struct {\n\tPayType string `json:\"pay_type\"`\n\tDefaultFlag string `json:\"default_flag\"`\n\tDirectdebit Directdebit `json:\"directdebit\"`\n\tReturnURL string `json:\"return_url\"`\n}\n\ntype Directdebit struct {\n\tApplicationType string `json:\"application_type\"`\n\tBankCode string `json:\"bank_code\"`\n\tBranchCode *string `json:\"branch_code,omitempty\"`\n\tAccountType *string `json:\"account_type,omitempty\"`\n\tAccountNumber *string `json:\"account_number,omitempty\"`\n\tAccountName *string `json:\"account_name,omitempty\"`\n\tAccountNameKana string `json:\"account_name_kana\"`\n\tPaperApplication *PaperApplication `json:\"paper_application,omitempty\"`\n}\n\ntype PaperApplication struct {\n\tPostalAccountNumber1 *string `json:\"postal_account_number_1,omitempty\"`\n\tPostalAccountNumber2 *string `json:\"postal_account_number_2,omitempty\"`\n\tRequestFormId string `json:\"request_form_id\"`\n}\n\nfunc stringPointer(s string) *string {\n\treturn &s\n}\n"
},
{
"lang": "node",
"label": "Node.js",
"source": "import fetch from \"node-fetch\";\n\nconst BASE_URL = \"https://api.test.fincode.jp\";\n\nconst API_KEY = \"\";\n\n(async () => {\n const customerId = \"\";\n\n const endpoint = `${BASE_URL}/v1/customers/${customerId}/payment_methods`;\n\n const response = await fetch(endpoint, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${API_KEY}`,\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify({\n pay_type: \"Directdebit\",\n default_flag: \"1\",\n return_url: \"https://your-service.example.com/return\",\n directdebit: {\n application_type: \"ONLINE\",\n bank_code: \"0310\",\n branch_code: \"000\",\n account_type: \"1\",\n account_number: \"0999999\",\n account_name_kana: \"ナマエカナ\",\n },\n }),\n });\n const paymentMethods = await response.json();\n})();\n"
},
{
"lang": "php",
"label": "PHP",
"source": "';\n\n$customerId = '';\n\n$baseUrl = \"https://api.test.fincode.jp\";\n$endpoint = \"/v1/customers/{$customerId}/payment_methods\";\n$headers = [\n \"Authorization: Bearer \" . $apiKey,\n \"Content-Type: application/json\"\n];\n\n$data = json_encode([\n \"pay_type\" => \"Directdebit\",\n \"default_flag\" => \"1\",\n \"return_url\" => \"https://your-service.example.com/return\",\n \"directdebit\" => [\n \"application_type\" => \"ONLINE\",\n \"bank_code\" => \"0310\",\n \"branch_code\" => \"000\",\n \"account_type\" => \"1\",\n \"account_number\" => \"0999999\",\n \"account_name_kana\" => \"ナマエカナ\"\n ]\n]);\n\n$session = curl_init();\ncurl_setopt($session, CURLOPT_URL, $baseUrl . $endpoint);\ncurl_setopt($session, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($session, CURLOPT_POST, true);\ncurl_setopt($session, CURLOPT_POSTFIELDS, $data);\ncurl_setopt($session, CURLOPT_RETURNTRANSFER, true);\n// curl_setopt($session, CURLOPT_SSL_VERIFYPEER, );\n// curl_setopt($session, CURLOPT_SSL_VERIFYHOST, );\n\n$response = curl_exec($session);\n\nif ($response === false) {\n # エラー処理\n echo \"cURL Error: \" . curl_error($session);\n} else {\n # APIからのデータを処理\n var_dump($response);\n}\n\ncurl_close($session);\n"
},
{
"lang": "python",
"label": "Python 3",
"source": "import requests\n\napi_key = ''\n\ncustomer_id = ''\n\nurl = f'https://api.test.fincode.jp/v1/customers/{customer_id}/payment_methods'\n\n# ヘッダーを設定\nheaders = {\n 'Authorization': f'Bearer {api_key}',\n 'Content-Type': 'application/json'\n}\n\ndata = {\n \"pay_type\": \"Directdebit\",\n \"default_flag\": \"1\",\n \"return_url\": \"https://your-service.example.com/return\",\n \"directdebit\": {\n \"application_type\": \"ONLINE\",\n \"bank_code\": \"0310\",\n \"branch_code\": \"000\",\n \"account_type\": \"1\",\n \"account_number\": \"0999999\",\n \"account_name_kana\": \"ナマエカナ\"\n }\n}\n\n# HTTP POSTリクエストの送信\ntry:\n response = requests.post(url, headers=headers, json=data)\n\n # レスポンスの処理\n if response.status_code == 200:\n # 成功した場合の処理\n print(f\"Success: {response.json()}\")\n else:\n # エラーの処理\n print(f\"Error: {response.json()}\")\nexcept requests.RequestException as e:\n # 通信エラーの処理\n print(f\"Request error: {e}\")\n"
},
{
"lang": "ruby",
"label": "Ruby",
"source": "require 'net/http'\nrequire 'uri'\nrequire 'json'\n\n\nAPI_KEY = ''\nBASE_URL = 'https://api.test.fincode.jp'\n\ndef main\n customer_id = ''\n endpoint = \"/v1/customers/#{customer_id}/payment_methods\"\n \n uri = URI.parse(BASE_URL + endpoint)\n\n http = Net::HTTP.new(uri.host, uri.port)\n http.use_ssl = true\n\n data = {\n pay_type: \"Directdebit\",\n default_flag: \"1\",\n return_url: \"https://your-service.example.com/return\",\n directdebit: {\n application_type: \"ONLINE\",\n bank_code: \"9999\",\n branch_code: \"000\",\n account_type: \"1\",\n account_number: \"0999999\",\n account_name_kana: \"ナマエカナ\"\n } \n }\n\n # リクエストの作成\n request = Net::HTTP::Post.new(uri.request_uri)\n request['Authorization'] = \"Bearer #{API_KEY}\"\n request['Content-Type'] = 'application/json'\n\n request.body = data.to_json\n\n # リクエストの送信\n response = http.request(request)\n\n case response\n when Net::HTTPSuccess\n puts 'SUCCESS'\n else\n puts 'ERROR'\n end\n\n # レスポンスの表示\n puts response.body\nend\n\nmain\n"
}
]
},
"get": {
"security": [
{
"Secret-Bearer-Auth": []
},
{
"Public-Bearer-Auth": []
},
{
"Secret-Basic-Auth": []
}
],
"operationId": "retrieveCustomerPaymentMethodList",
"tags": [
"決済手段"
],
"summary": "決済手段 一覧取得",
"description": "`customer_id`で指定した顧客に対し紐づく決済手段を一覧で取得します。\n",
"parameters": [
{
"name": "customer_id",
"in": "path",
"description": "顧客ID",
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/CustomerId_schema"
}
]
},
"required": true
},
{
"name": "クエリ",
"in": "query",
"required": true,
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/CustomerPaymentMethod.ListRetrieving.QueryParams"
}
]
},
"description": "決済手段の一覧取得において検索条件となるクエリパラメータ\n"
},
{
"in": "header",
"name": "Tenant-Shop-Id",
"required": false,
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/schema"
}
]
},
"description": "※ 顧客情報を共有しないプラットフォームのメインショップのみ指定可\\\nテナントショップID。\\\nこのテナントショップに紐づく顧客のうち、指定したIDの顧客に紐づく決済手段から一覧で取得します。\n"
}
],
"responses": {
"200": {
"description": "リクエストに成功",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CustomerPaymentMethod.ListRetrieving.Response"
}
}
}
},
"400": {
"description": "不正なリクエスト",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FincodeAPIError.Response"
}
}
}
}
},
"x-code-samples": [
{
"lang": "curl",
"label": "cURL",
"source": "curl \\\n -X GET \\\n -H \"Authorization:Bearer \" \\\n'https://api.test.fincode.jp/v1/customers/{customer_id}/payment_methods?pay_type=Directdebit'\n"
},
{
"lang": "go",
"label": "Go",
"source": "package main\n\nimport (\n\t\"fmt\"\n\t\"log\"\n\t\"net/http\"\n)\n\nfunc main() {\n\n\tapiKey := \"\"\n\n\tcustomerID := \"\"\n\n\t// リクエストの作成\n\treq, _ := http.NewRequest(\n\t\t\"GET\",\n\t\tfmt.Sprintf(\"https://api.test.fincode.jp/v1/customers/%s/payment_methods\", customerID),\n\t\tnil,\n\t)\n\treq.Header.Set(\"Authorization\", fmt.Sprintf(\"Bearer %s\", apiKey))\n\n\tparams := req.URL.Query()\n\tparams.Add(\"pay_type\", \"Directdebit\")\n\treq.URL.RawQuery = params.Encode()\n\n\t// リクエストの送信\n\tclient := &http.Client{}\n\tres, err := client.Do(req)\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\tdefer res.Body.Close()\n\n}\n"
},
{
"lang": "node",
"label": "Node.js",
"source": "import fetch from \"node-fetch\";\n\nconst BASE_URL = \"https://api.test.fincode.jp\";\n\nconst API_KEY = \"\";\n\n(async () => {\n const customerId = \"\";\n\n const endpoint = `${BASE_URL}/v1/customers/${customerId}/payment_methods`;\n\n const response = await fetch(endpoint, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${API_KEY}`,\n },\n });\n const paymentMethods = await response.json();\n})();\n"
},
{
"lang": "php",
"label": "PHP",
"source": "';\n\n$customerId = '';\n\n$baseUrl = \"https://api.test.fincode.jp\";\n$endpoint = \"/v1/customers/{$customerId}/payment_methods\";\n$queryParams = [\n \"pay_type\" => \"Directdebit\",\n];\n\n$headers = [\n \"Authorization: Bearer \" . $apiKey,\n];\n\n$session = curl_init();\ncurl_setopt($session, CURLOPT_URL, $baseUrl . $endpoint . \"?\" . http_build_query($queryParams));\ncurl_setopt($session, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($session, CURLOPT_HTTPGET, true);\ncurl_setopt($session, CURLOPT_RETURNTRANSFER, true);\n// curl_setopt($session, CURLOPT_SSL_VERIFYPEER, );\n// curl_setopt($session, CURLOPT_SSL_VERIFYHOST, );\n\n$response = curl_exec($session);\n\nif ($response === false) {\n # エラー処理\n echo \"cURL Error: \" . curl_error($session);\n} else {\n # APIからのデータを処理\n var_dump($response);\n}\n\ncurl_close($session);\n"
},
{
"lang": "python",
"label": "Python 3",
"source": "import requests\n\napi_key = ''\n\ncustomer_id = ''\n\nurl = f'https://api.test.fincode.jp/v1/customers/{customer_id}/payment_methods'\nquery_params = {\n 'pay_type': 'Directdebit',\n}\n\n# ヘッダーを設定\nheaders = {\n 'Authorization': f'Bearer {api_key}',\n}\n\ntry:\n response = requests.get(url, headers=headers, params=query_params)\n\n # レスポンスの処理\n if response.status_code == 200:\n # APIからのデータを処理\n print(f\"Success: {response.json()}\")\n else:\n # エラーの処理\n print(f\"Error: {response.json()}\")\nexcept requests.RequestException as e:\n # 通信エラーの処理\n print(f\"Request error: {e}\")\n"
},
{
"lang": "ruby",
"label": "Ruby",
"source": "require 'net/http'\nrequire 'uri'\n\nAPI_KEY = ''\nBASE_URL = 'https://api.test.fincode.jp'\n\ndef main\n customer_id = ''\n\n endpoint = \"/v1/customers/#{customer_id}/payment_methods\"\n query_params = { \n limit: 10,\n pay_type: 'Directdebit',\n }\n\n uri = URI.parse(BASE_URL + endpoint)\n uri.query = URI.encode_www_form(query_params)\n\n http = Net::HTTP.new(uri.host, uri.port)\n http.use_ssl = true\n\n # リクエストの作成\n request = Net::HTTP::Get.new(uri.request_uri)\n request['Authorization'] = \"Bearer #{API_KEY}\"\n\n # リクエストの送信\n response = http.request(request)\n\n case response\n when Net::HTTPSuccess\n puts 'SUCCESS'\n else\n puts 'ERROR'\n end\n\n # レスポンスの表示\n puts response.body\nend\n\nmain\n"
}
]
}
},
"/v1/customers/{customer_id}/payment_methods/{id}": {
"get": {
"security": [
{
"Secret-Bearer-Auth": []
},
{
"Public-Bearer-Auth": []
},
{
"Secret-Basic-Auth": []
}
],
"operationId": "retrieveCustomerPaymentMethod",
"tags": [
"決済手段"
],
"summary": "決済手段 取得",
"description": "`customer_id`で指定した顧客に対し紐づく決済手段のうち、`id`で指定したものを取得します。\n",
"parameters": [
{
"name": "customer_id",
"in": "path",
"description": "顧客ID",
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/CustomerId_schema"
}
]
},
"required": true
},
{
"name": "id",
"in": "path",
"description": "決済手段ID\\\n※ `pay_type = Card`（カード）の場合は `cs_` から始まるIDになります。\n",
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/PaymentMethodId_schema"
}
]
},
"required": true,
"examples": {
"payment_method": {
"$ref": "#/components/examples/payment_method"
},
"card": {
"$ref": "#/components/examples/card"
}
}
},
{
"name": "Tenant-Shop-Id",
"in": "header",
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/schema"
}
]
},
"description": "※ 顧客情報を共有しないプラットフォームのメインショップのみ指定可\\\nテナントショップID。\\\nこのテナントショップに紐づく顧客のうち、指定したIDの顧客に紐づく決済手段からIDで指定した決済手段を取得します。\n"
},
{
"name": "クエリ",
"in": "query",
"required": true,
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/CustomerPaymentMethod.Retrieving.QueryParams"
}
]
},
"description": "決済手段の取得において検索条件となるクエリパラメータ\n"
}
],
"responses": {
"200": {
"description": "リクエストに成功",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CustomerPaymentMethod.Retrieving.Response"
}
}
}
},
"400": {
"description": "不正なリクエスト",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FincodeAPIError.Response"
}
}
}
}
},
"x-code-samples": [
{
"lang": "curl",
"label": "cURL",
"source": "curl \\\n -X GET \\\n -H \"Authorization:Bearer \" \\\n'https://api.test.fincode.jp/v1/customers/{customer_id}/payment_methods/{id}?pay_type=Card'\n"
},
{
"lang": "node",
"label": "Node.js",
"source": "import fetch from \"node-fetch\";\n\nconst BASE_URL = \"https://api.test.fincode.jp\";\n\nconst API_KEY = \"\";\n\n(async () => {\n const customerId = \"\";\n const paymentMethodId = \"\";\n\n const queryParams = new URLSearchParams({\n pay_type: \"Card\",\n });\n\n const endpoint = `${BASE_URL}/v1/customers/${customerId}/payment_methods/${paymentMethodId}?${queryParams}`;\n\n const response = await fetch(endpoint, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${API_KEY}`,\n },\n });\n const paymentMethod = await response.json();\n})();\n"
},
{
"lang": "go",
"label": "Go",
"source": "package main\n\nimport (\n\t\"fmt\"\n\t\"log\"\n\t\"net/http\"\n)\n\nfunc main() {\n\n\tapiKey := \"\"\n\n\tcustomerID := \"\"\n\tpaymentMethodID := \"\"\n\n\t// リクエストの作成\n\treq, _ := http.NewRequest(\n\t\t\"GET\",\n\t\tfmt.Sprintf(\"https://api.test.fincode.jp/v1/customers/%s/payment_methods/%s\", customerID, paymentMethodID),\n\t\tnil,\n\t)\n\treq.Header.Set(\"Authorization\", fmt.Sprintf(\"Bearer %s\", apiKey))\n\n\tparams := req.URL.Query()\n\tparams.Add(\"pay_type\", \"Card\")\n\treq.URL.RawQuery = params.Encode()\n\n\t// リクエストの送信\n\tclient := &http.Client{}\n\tres, err := client.Do(req)\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\tdefer res.Body.Close()\n\n}\n"
},
{
"lang": "php",
"label": "PHP",
"source": "';\n\n$customerId = '';\n$paymentMethodId = '';\n\n$baseUrl = \"https://api.test.fincode.jp\";\n$endpoint = \"/v1/customers/{$customerId}/payment_methods/{$paymentMethodId}\";\n$queryParams = [\n \"pay_type\" => \"Card\",\n];\n\n$headers = [\n \"Authorization: Bearer \" . $apiKey,\n];\n\n$session = curl_init();\ncurl_setopt($session, CURLOPT_URL, $baseUrl . $endpoint . '?' . http_build_query($queryParams));\ncurl_setopt($session, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($session, CURLOPT_HTTPGET, true);\ncurl_setopt($session, CURLOPT_RETURNTRANSFER, true);\n// curl_setopt($session, CURLOPT_SSL_VERIFYPEER, );\n// curl_setopt($session, CURLOPT_SSL_VERIFYHOST, );\n\n$response = curl_exec($session);\n\nif ($response === false) {\n # エラー処理\n echo \"cURL Error: \" . curl_error($session);\n} else {\n # APIからのデータを処理\n var_dump($response);\n}\n\ncurl_close($session);\n"
},
{
"lang": "python",
"label": "Python 3",
"source": "import requests\n\napi_key = ''\n\ncustomer_id = ''\npayment_method_id = ''\n\nurl = f'https://api.test.fincode.jp/v1/customers/{customer_id}/payment_methods/{payment_method_id}/'\nquery_params = {\n 'pay_type': 'Card',\n}\n\n# ヘッダーを設定\nheaders = {\n 'Authorization': f'Bearer {api_key}',\n}\n\ntry:\n response = requests.get(url, headers=headers, params=query_params)\n\n # レスポンスの処理\n if response.status_code == 200:\n # APIからのデータを処理\n print(f\"Success: {response.json()}\")\n else:\n # エラーの処理\n print(f\"Error: {response.json()}\")\nexcept requests.RequestException as e:\n # 通信エラーの処理\n print(f\"Request error: {e}\")\n"
},
{
"lang": "ruby",
"label": "Ruby",
"source": "require 'net/http'\nrequire 'uri'\n\nAPI_KEY = ''\nBASE_URL = 'https://api.test.fincode.jp'\n\ndef main\n customer_id = ''\n payment_method_id = ''\n\n endpoint = \"/v1/customers/#{customer_id}/payment_methods/#{payment_method_id}\"\n query_params = {\n limit: 10,\n pay_type: 'Card',\n }\n\n uri = URI.parse(BASE_URL + endpoint)\n uri.query = URI.encode_www_form(query_params)\n\n http = Net::HTTP.new(uri.host, uri.port)\n http.use_ssl = true\n\n # リクエストの作成\n request = Net::HTTP::Get.new(uri.request_uri)\n request['Authorization'] = \"Bearer #{API_KEY}\"\n\n # リクエストの送信\n response = http.request(request)\n\n case response\n when Net::HTTPSuccess\n puts 'SUCCESS'\n else\n puts 'ERROR'\n end\n\n # レスポンスの表示\n puts response.body\nend\n\nmain\n"
}
]
},
"delete": {
"security": [
{
"Secret-Bearer-Auth": []
},
{
"Public-Bearer-Auth": []
},
{
"Secret-Basic-Auth": []
}
],
"operationId": "deleteCustomerPaymentMethod",
"tags": [
"決済手段"
],
"summary": "決済手段 削除",
"description": "`customer_id`で指定した顧客に対し紐づく決済手段のうち、`id`で指定したものを削除します。\n",
"parameters": [
{
"name": "customer_id",
"in": "path",
"description": "顧客ID",
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/CustomerId_schema"
}
]
},
"required": true
},
{
"name": "id",
"in": "path",
"description": "決済手段ID\\\n※ `pay_type = Card`（カード）の場合は `cs_` から始まるIDになります。\n",
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/PaymentMethodId_schema"
}
]
},
"required": true,
"examples": {
"payment_method": {
"$ref": "#/components/examples/payment_method"
},
"card": {
"$ref": "#/components/examples/card"
}
}
},
{
"name": "Tenant-Shop-Id",
"in": "header",
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/schema"
}
]
},
"description": "※ 顧客情報を共有しないプラットフォームのメインショップのみ指定可\\\nテナントショップID。\\\nこのテナントショップに紐づく顧客のうち、指定したIDの顧客に紐づく決済手段からIDで指定した決済手段を削除します。\n"
},
{
"in": "query",
"name": "pay_type",
"required": true,
"description": "決済種別\n- `Card` - カード\n- `Directdebit` - 口座振替\n- `Virtualaccount` - 銀行振込（バーチャル口座）\n",
"schema": {
"type": "string",
"minLength": 1,
"maxLength": 50
}
}
],
"responses": {
"200": {
"description": "リクエストに成功",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CustomerPaymentMethod.Deleting.Response"
}
}
}
},
"400": {
"description": "不正なリクエスト",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FincodeAPIError.Response"
}
}
}
}
},
"x-code-samples": [
{
"lang": "curl",
"label": "cURL",
"source": "curl \\\n -X DELETE \\\n -H \"Authorization:Bearer \" \\\n'https://api.test.fincode.jp/v1/customers/{customer_id}/payment_methods/{id}?pay_type=Card'\n"
},
{
"lang": "node",
"label": "Node.js",
"source": "import fetch from \"node-fetch\";\n\nconst BASE_URL = \"https://api.test.fincode.jp\";\n\nconst API_KEY = \"\";\n\n(async () => {\n const customerId = \"\";\n const paymentMethodId = \"\";\n\n const queryParams = new URLSearchParams({\n pay_type: \"Card\",\n });\n\n const endpoint = `${BASE_URL}/v1/customers/${customerId}/payment_methods/${paymentMethodId}?${queryParams}`;\n\n const response = await fetch(endpoint, {\n method: \"DELETE\",\n headers: {\n Authorization: `Bearer ${API_KEY}`,\n },\n });\n const result = await response.json();\n})();\n"
},
{
"lang": "go",
"label": "Go",
"source": "package main\n\nimport (\n\t\"fmt\"\n\t\"log\"\n\t\"net/http\"\n)\n\nfunc main() {\n\n\tapiKey := \"\"\n\n\tcustomerID := \"\"\n\tpaymentMethodID := \"\"\n\n\t// リクエストの作成\n\treq, _ := http.NewRequest(\n\t\t\"DELETE\",\n\t\tfmt.Sprintf(\"https://api.test.fincode.jp/v1/customers/%s/payment_methods/%s\", customerID, paymentMethodID),\n\t\tnil,\n\t)\n\treq.Header.Set(\"Authorization\", fmt.Sprintf(\"Bearer %s\", apiKey))\n\n\tparams := req.URL.Query()\n\tparams.Add(\"pay_type\", \"Card\")\n\treq.URL.RawQuery = params.Encode()\n\n\t// リクエストの送信\n\tclient := &http.Client{}\n\tres, err := client.Do(req)\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\tdefer res.Body.Close()\n}\n"
},
{
"lang": "php",
"label": "PHP",
"source": "';\n\n$customerId = '';\n$paymentMethodId = '';\n\n$baseUrl = \"https://api.test.fincode.jp\";\n$endpoint = \"/v1/customers/{$customerId}/payment_methods/{$paymentMethodId}\";\n$queryParams = [\n \"pay_type\" => \"Card\",\n];\n\n$headers = [\n \"Authorization: Bearer \" . $apiKey,\n];\n\n$session = curl_init();\ncurl_setopt($session, CURLOPT_URL, $baseUrl . $endpoint . \"?\" . http_build_query($queryParams));\ncurl_setopt($session, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($session, CURLOPT_CUSTOMREQUEST, 'DELETE');\ncurl_setopt($session, CURLOPT_RETURNTRANSFER, true);\n// curl_setopt($session, CURLOPT_SSL_VERIFYPEER, );\n// curl_setopt($session, CURLOPT_SSL_VERIFYHOST, );\n\n$response = curl_exec($session);\n\nif ($response === false) {\n # エラー処理\n echo \"cURL Error: \" . curl_error($session);\n} else {\n # APIからのデータを処理\n var_dump($response);\n}\n\ncurl_close($session);\n"
},
{
"lang": "python",
"label": "Python 3",
"source": "import requests\n\napi_key = ''\n\ncustomer_id = ''\npayment_method_id = ''\n\nurl = f'https://api.test.fincode.jp/v1/customers/{customer_id}/payment_methods/{payment_method_id}/'\nquery_params = {\n 'pay_type': 'Card',\n}\n\n# ヘッダーを設定\nheaders = {\n 'Authorization': f'Bearer {api_key}',\n}\n\ntry:\n response = requests.delete(url, headers=headers, params=query_params)\n\n # レスポンスの処理\n if response.status_code == 200:\n # APIからのデータを処理\n print(f\"Success: {response.json()}\")\n else:\n # エラーの処理\n print(f\"Error: {response.json()}\")\nexcept requests.RequestException as e:\n # 通信エラーの処理\n print(f\"Request error: {e}\")\n"
},
{
"lang": "ruby",
"label": "Ruby",
"source": "require 'net/http'\nrequire 'uri'\n\nAPI_KEY = ''\nBASE_URL = 'https://api.test.fincode.jp'\n\ndef main\n customer_id = ''\n payment_method_id = ''\n \n endpoint = \"/v1/customers/#{customer_id}/payment_methods/#{payment_method_id}\"\n query_params = {\n limit: 10,\n pay_type: 'Card',\n }\n\n uri = URI.parse(BASE_URL + endpoint)\n uri.query = URI.encode_www_form(query_params)\n\n http = Net::HTTP.new(uri.host, uri.port)\n http.use_ssl = true\n\n # リクエストの作成\n request = Net::HTTP::Delete.new(uri.request_uri)\n request['Authorization'] = \"Bearer #{API_KEY}\"\n\n # リクエストの送信\n response = http.request(request)\n\n case response\n when Net::HTTPSuccess\n puts 'SUCCESS'\n else\n puts 'ERROR'\n end\n\n # レスポンスの表示\n puts response.body\nend\n\nmain\n"
}
]
},
"put": {
"security": [
{
"Secret-Bearer-Auth": []
},
{
"Public-Bearer-Auth": []
},
{
"Secret-Basic-Auth": []
}
],
"operationId": "updateCustomerPaymentMethod",
"tags": [
"決済手段"
],
"summary": "決済手段 更新",
"description": "`customer_id`で指定した顧客に対し紐づく決済手段のうち、`id`で指定したものを更新します。\n",
"parameters": [
{
"name": "customer_id",
"in": "path",
"description": "顧客ID",
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/CustomerId_schema"
}
]
},
"required": true
},
{
"name": "id",
"in": "path",
"description": "決済手段ID\\\n※ `pay_type = Card`（カード）の場合は `cs_` から始まるIDになります。\n",
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/PaymentMethodId_schema"
}
]
},
"required": true,
"examples": {
"payment_method": {
"$ref": "#/components/examples/payment_method"
},
"card": {
"$ref": "#/components/examples/card"
}
}
},
{
"name": "Tenant-Shop-Id",
"in": "header",
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/schema"
}
]
},
"description": "※ 顧客情報を共有しないプラットフォームのメインショップのみ指定可\\\nテナントショップID。\\\nこのテナントショップに紐づく顧客のうち、指定したIDの顧客に紐づく決済手段からIDで指定した決済手段を削除します。\n"
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"pay_type"
],
"properties": {
"pay_type": {
"type": "string",
"minLength": 1,
"maxLength": 50,
"description": "決済種別\n\n* `Card` - カード\n* `Virtualaccount` - 銀行振込（バーチャル口座）\n\n\n ※ 現時点ではCard（カード）、Virtualaccount（銀行振込（バーチャル口座））のみ指定可能です。\n\n"
},
"default_flag": {
"type": "string",
"enum": [
"1"
],
"minLength": 1,
"maxLength": 1,
"description": "デフォルトフラグ\n* `1` - デフォルト\n"
},
"return_url": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/return_url"
}
],
"description": "※ `pay_type = \"Card\"`のとき指定可能\n"
},
"return_url_on_failure": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/return_url_on_failure"
}
],
"description": "※ `pay_type = \"Card\"`のとき指定可能\n"
},
"client_field_1": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/client_field_1"
}
],
"description": "加盟店自由項目 1\\\n※ `pay_type = \"Card\"`のとき指定可能\n"
},
"client_field_2": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/client_field_2"
}
],
"description": "加盟店自由項目 2\\\n※ `pay_type = \"Card\"`のとき指定可能\n"
},
"client_field_3": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/client_field_3"
}
],
"description": "加盟店自由項目 3\\\n※ `pay_type = \"Card\"`のとき指定可能\n"
},
"card": {
"type": "object",
"nullable": true,
"description": "※ `pay_type = \"Card\"`のとき指定可能。カード情報自体（カード番号）は変更できません。省略した場合は`default_flag`/`client_field_*`のみが更新されます。\n",
"properties": {
"token": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/token"
}
],
"description": "カードトークン\\\n指定した場合、トークンを用いてカード情報（有効期限・セキュリティコード等）を更新します。`expire`/`holder_name`/`security_code`を直接指定する場合は省略可能です。\n"
},
"expire": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/properties-expire"
}
],
"description": "カード有効期限\\\n`token`未指定時は必須\\\n形式：`YYMM`\n"
},
"holder_name": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/properties-holder_name"
}
],
"description": "カード名義人名\\\n`token`未指定時のみ指定可能\n"
},
"security_code": {
"nullable": true,
"type": "string",
"minLength": 1,
"maxLength": 6,
"example": "123",
"description": "セキュリティコード\\\n`token`未指定時のみ指定可能\n"
},
"card_updater_mode": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/card_updater_mode"
}
],
"description": "洗替対象設定\\\n洗替対象設定を変更する場合のみ指定します（省略可能）\n\n- `enabled`：カード更新する\n- `disabled`：カード更新しない\n- `inherit`：ショップ設定に準ずる（デフォルト）\n"
},
"tds_type": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds_type"
}
],
"description": "3Dセキュア認証を利用するか。\\\n※ カード情報（`token`・`holder_name`・`expire`等）を更新する場合は必須\n\n- `0`: 3Dセキュア認証を利用しない\n- `2`: 3Dセキュア2.0認証を利用する\n"
},
"tds2_type": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_type"
}
]
},
"td_tenant_name": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/td_tenant_name"
}
]
},
"tds2_ret_url": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_ret_url"
}
]
},
"tds2_ch_acc_change": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_ch_acc_change"
}
]
},
"tds2_ch_acc_date": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_ch_acc_date"
}
]
},
"tds2_ch_acc_pw_change": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_ch_acc_pw_change"
}
]
},
"tds2_nb_purchase_account": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_nb_purchase_account"
}
]
},
"tds2_payment_acc_age": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_payment_acc_age"
}
]
},
"tds2_provision_attempts_day": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_provision_attempts_day"
}
]
},
"tds2_ship_address_usage": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_ship_address_usage"
}
]
},
"tds2_ship_name_ind": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_ship_name_ind"
}
]
},
"tds2_suspicious_acc_activity": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_suspicious_acc_activity"
}
]
},
"tds2_txn_activity_day": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_txn_activity_day"
}
]
},
"tds2_txn_activity_year": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_txn_activity_year"
}
]
},
"tds2_three_ds_req_auth_data": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_three_ds_req_auth_data"
}
]
},
"tds2_three_ds_req_auth_method": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_three_ds_req_auth_method"
}
]
},
"tds2_three_ds_req_auth_timestamp": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_three_ds_req_auth_timestamp"
}
]
},
"tds2_email": {
"allOf": [
{
"$ref": "#/components/schemas/tds2_email"
}
]
},
"tds2_addr_match": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_addr_match"
}
]
},
"tds2_bill_addr_country": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_bill_addr_country"
}
]
},
"tds2_bill_addr_state": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_bill_addr_state"
}
]
},
"tds2_bill_addr_city": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_bill_addr_city"
}
]
},
"tds2_bill_addr_line_1": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_bill_addr_line_1"
}
]
},
"tds2_bill_addr_line_2": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_bill_addr_line_2"
}
]
},
"tds2_bill_addr_line_3": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_bill_addr_line_3"
}
]
},
"tds2_bill_addr_post_code": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_bill_addr_post_code"
}
]
},
"tds2_ship_addr_country": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_ship_addr_country"
}
]
},
"tds2_ship_addr_state": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_ship_addr_state"
}
]
},
"tds2_ship_addr_city": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_ship_addr_city"
}
]
},
"tds2_ship_addr_line_1": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_ship_addr_line_1"
}
]
},
"tds2_ship_addr_line_2": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_ship_addr_line_2"
}
]
},
"tds2_ship_addr_line_3": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_ship_addr_line_3"
}
]
},
"tds2_ship_addr_post_code": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_ship_addr_post_code"
}
]
},
"tds2_ship_ind": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_ship_ind"
}
]
},
"tds2_delivery_email_address": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_delivery_email_address"
}
]
},
"tds2_home_phone_cc": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_home_phone_cc"
}
]
},
"tds2_home_phone_no": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_home_phone_no"
}
]
},
"tds2_mobile_phone_cc": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_mobile_phone_cc"
}
]
},
"tds2_mobile_phone_no": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_mobile_phone_no"
}
]
},
"tds2_work_phone_cc": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_work_phone_cc"
}
]
},
"tds2_work_phone_no": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_work_phone_no"
}
]
},
"tds2_delivery_timeframe": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_delivery_timeframe"
}
]
},
"tds2_pre_order_date": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_pre_order_date"
}
]
},
"tds2_pre_order_purchase_ind": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_pre_order_purchase_ind"
}
]
},
"tds2_reorder_items_ind": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_reorder_items_ind"
}
]
},
"tds2_recurring_expiry": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_recurring_expiry"
}
]
},
"tds2_recurring_frequency": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_recurring_frequency"
}
]
},
"tds2_gift_card_amount": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_gift_card_amount"
}
]
},
"tds2_gift_card_count": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_gift_card_count"
}
]
},
"tds2_gift_card_curr": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/tds2_gift_card_curr"
}
]
}
}
}
}
}
}
}
},
"responses": {
"200": {
"description": "リクエストに成功",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CustomerPaymentMethod.Updating.Response"
}
}
}
},
"400": {
"description": "不正なリクエスト",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FincodeAPIError.Response"
}
}
}
}
},
"x-code-samples": [
{
"lang": "curl",
"label": "cURL",
"source": "curl \\\n -X PUT \\\n -H \"Authorization:Bearer \" \\\n -H \"Content-Type:application/json\" \\\n -d '{\"pay_type\": \"Card\", \"default_flag\": \"1\"}' \\\n'https://api.test.fincode.jp/v1/customers/{customer_id}/payment_methods/{id}'\n"
},
{
"lang": "node",
"label": "Node.js",
"source": "import fetch from \"node-fetch\";\n\nconst BASE_URL = \"https://api.test.fincode.jp\";\n\nconst API_KEY = \"\";\n\n(async () => {\n const customerId = \"\";\n const paymentMethodId = \"\";\n\n const endpoint = `${BASE_URL}/v1/customers/${customerId}/payment_methods/${paymentMethodId}`;\n\n const body = {\n pay_type: \"Card\",\n default_flag: \"1\",\n };\n\n const response = await fetch(endpoint, {\n method: \"PUT\",\n headers: {\n Authorization: `Bearer ${API_KEY}`,\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify(body),\n });\n const result = await response.json();\n})();\n"
},
{
"lang": "go",
"label": "Go",
"source": "package main\n\nimport (\n\t\"bytes\"\n\t\"encoding/json\"\n\t\"fmt\"\n\t\"log\"\n\t\"net/http\"\n)\n\nfunc main() {\n\n\tapiKey := \"\"\n\n\tcustomerID := \"\"\n\tpaymentMethodID := \"\"\n\n\tbody := UpdatingPaymentMethodRequest{\n\t\tPayType: \"Card\",\n\t\tDefaultFlag: \"1\",\n\t}\n\n\tmarshalledBody, _ := json.Marshal(body)\n\n\turl := fmt.Sprintf(\"https://api.test.fincode.jp/v1/customers/%s/payment_methods/%s\", customerID, paymentMethodID)\n\n\t// リクエストの作成\n\treq, _ := http.NewRequest(\n\t\t\"PUT\",\n\t\turl,\n\t\tbytes.NewBuffer(marshalledBody),\n\t)\n\treq.Header.Set(\"Authorization\", fmt.Sprintf(\"Bearer %s\", apiKey))\n\treq.Header.Set(\"Content-Type\", \"application/json\")\n\n\t// リクエストの送信\n\tclient := &http.Client{}\n\tres, err := client.Do(req)\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\tdefer res.Body.Close()\n}\n\ntype UpdatingPaymentMethodRequest struct {\n\tPayType string `json:\"pay_type\"`\n\tDefaultFlag string `json:\"default_flag\"`\n}\n"
},
{
"lang": "php",
"label": "PHP",
"source": "';\n\n$customerId = '';\n$paymentMethodId = '';\n\n$baseUrl = \"https://api.test.fincode.jp\";\n$endpoint = \"/v1/customers/{$customerId}/payment_methods/{$paymentMethodId}\";\n$body = [\n \"pay_type\" => \"Card\",\n \"default_flag\" => \"1\",\n];\n\n$headers = [\n \"Authorization: Bearer \" . $apiKey,\n \"Content-Type: application/json\",\n];\n\n$session = curl_init();\ncurl_setopt($session, CURLOPT_URL, $baseUrl . $endpoint);\ncurl_setopt($session, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($session, CURLOPT_CUSTOMREQUEST, 'PUT');\ncurl_setopt($session, CURLOPT_POSTFIELDS, json_encode($body));\ncurl_setopt($session, CURLOPT_RETURNTRANSFER, true);\n// curl_setopt($session, CURLOPT_SSL_VERIFYPEER, );\n// curl_setopt($session, CURLOPT_SSL_VERIFYHOST, );\n\n$response = curl_exec($session);\n\nif ($response === false) {\n # エラー処理\n echo \"cURL Error: \" . curl_error($session);\n} else {\n # APIからのデータを処理\n var_dump($response);\n}\n\ncurl_close($session);\n"
},
{
"lang": "python",
"label": "Python 3",
"source": "import requests\n\napi_key = ''\n\ncustomer_id = ''\npayment_method_id = ''\n\nurl = f'https://api.test.fincode.jp/v1/customers/{customer_id}/payment_methods/{payment_method_id}/'\nbody = {\n 'pay_type': 'Card',\n 'default_flag': '1',\n}\n\n# ヘッダーを設定\nheaders = {\n 'Authorization': f'Bearer {api_key}',\n 'Content-Type': 'application/json',\n}\n\ntry:\n response = requests.put(url, headers=headers, json=body)\n\n # レスポンスの処理\n if response.status_code == 200:\n # APIからのデータを処理\n print(f\"Success: {response.json()}\")\n else:\n # エラーの処理\n print(f\"Error: {response.json()}\")\nexcept requests.RequestException as e:\n # 通信エラーの処理\n print(f\"Request error: {e}\")\n"
},
{
"lang": "ruby",
"label": "Ruby",
"source": "require 'net/http'\nrequire 'uri'\nrequire 'json'\n\nAPI_KEY = ''\nBASE_URL = 'https://api.test.fincode.jp'\n\ndef main\n customer_id = ''\n payment_method_id = ''\n\n endpoint = \"/v1/customers/#{customer_id}/payment_methods/#{payment_method_id}\"\n body = {\n pay_type: 'Card',\n default_flag: '1',\n }\n\n uri = URI.parse(BASE_URL + endpoint)\n\n http = Net::HTTP.new(uri.host, uri.port)\n http.use_ssl = true\n\n # リクエストの作成\n request = Net::HTTP::Put.new(uri.request_uri)\n request['Authorization'] = \"Bearer #{API_KEY}\"\n request['Content-Type'] = 'application/json'\n request.body = body.to_json\n\n # リクエストの送信\n response = http.request(request)\n\n case response\n when Net::HTTPSuccess\n puts 'SUCCESS'\n else\n puts 'ERROR'\n end\n\n # レスポンスの表示\n puts response.body\nend\n\nmain\n"
}
]
}
},
"/v1/customers/{customer_id}/payment_methods/{id}/reactivate": {
"put": {
"security": [
{
"Secret-Bearer-Auth": []
},
{
"Public-Bearer-Auth": []
},
{
"Secret-Basic-Auth": []
}
],
"operationId": "reactivateCustomerPaymentMethod",
"tags": [
"決済手段"
],
"summary": "決済手段 再有効化",
"description": "`customer_id`で指定した顧客に対し紐づくバーチャル口座決済手段のうち、`id`で指定したものを再有効化します。\n",
"parameters": [
{
"name": "customer_id",
"in": "path",
"description": "顧客ID",
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/CustomerId_schema"
}
]
},
"required": true
},
{
"name": "id",
"in": "path",
"description": "決済手段ID\\\n※ `pay_type = Card`（カード）の場合は `cs_` から始まるIDになります。\n",
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/PaymentMethodId_schema"
}
]
},
"required": true
},
{
"name": "Tenant-Shop-Id",
"in": "header",
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/schema"
}
]
},
"description": "※ 顧客情報を共有しないプラットフォームのメインショップのみ指定可\\\nテナントショップID。\\\nこのテナントショップに紐づく顧客のうち、指定したIDの顧客に紐づく決済手段からIDで指定した決済手段を削除します。\n"
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"pay_type"
],
"properties": {
"pay_type": {
"type": "string",
"minLength": 1,
"maxLength": 50,
"description": "決済種別\n\n* `Virtualaccount` - 銀行振込（バーチャル口座）\n"
}
}
}
}
}
},
"responses": {
"200": {
"description": "リクエストに成功",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CustomerPaymentMethod.Inactivating.Response"
}
}
}
},
"400": {
"description": "不正なリクエスト",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FincodeAPIError.Response"
}
}
}
}
},
"x-code-samples": [
{
"lang": "curl",
"label": "cURL",
"source": "curl \\\n -X PUT \\\n -H \"Authorization:Bearer \" \\\n'https://api.test.fincode.jp/v1/customers/{customer_id}/payment_methods/{id}/reactivate?pay_type=Virtualaccount'\n"
},
{
"lang": "node",
"label": "Node.js",
"source": "import fetch from \"node-fetch\";\n\nconst BASE_URL = \"https://api.test.fincode.jp\";\n\nconst API_KEY = \"\";\n\n(async () => {\n const customerId = \"\";\n const paymentMethodId = \"\";\n\n const queryParams = new URLSearchParams({\n pay_type: \"Virtualaccount\",\n });\n\n const endpoint = `${BASE_URL}/v1/customers/${customerId}/payment_methods/${paymentMethodId}/reactivate?${queryParams}`;\n\n const response = await fetch(endpoint, {\n method: \"PUT\",\n headers: {\n Authorization: `Bearer ${API_KEY}`,\n },\n });\n const result = await response.json();\n})();\n"
},
{
"lang": "go",
"label": "Go",
"source": "package main\n\nimport (\n\t\"fmt\"\n\t\"log\"\n\t\"net/http\"\n)\n\nfunc main() {\n\n\tapiKey := \"\"\n\n\tcustomerID := \"\"\n\tpaymentMethodID := \"\"\n\n\t// リクエストの作成\n\treq, _ := http.NewRequest(\n\t\t\"PUT\",\n\t\tfmt.Sprintf(\"https://api.test.fincode.jp/v1/customers/%s/payment_methods/%s/reactivate\", customerID, paymentMethodID),\n\t\tnil,\n\t)\n\treq.Header.Set(\"Authorization\", fmt.Sprintf(\"Bearer %s\", apiKey))\n\n\tparams := req.URL.Query()\n\tparams.Add(\"pay_type\", \"Virtualaccount\")\n\treq.URL.RawQuery = params.Encode()\n\n\t// リクエストの送信\n\tclient := &http.Client{}\n\tres, err := client.Do(req)\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\tdefer res.Body.Close()\n}\n"
},
{
"lang": "php",
"label": "PHP",
"source": "';\n\n$customerId = '';\n$paymentMethodId = '';\n\n$baseUrl = \"https://api.test.fincode.jp\";\n$endpoint = \"/v1/customers/{$customerId}/payment_methods/{$paymentMethodId}/reactivate\";\n$queryParams = [\n \"pay_type\" => \"Virtualaccount\",\n];\n\n$headers = [\n \"Authorization: Bearer \" . $apiKey,\n];\n\n$session = curl_init();\ncurl_setopt($session, CURLOPT_URL, $baseUrl . $endpoint . \"?\" . http_build_query($queryParams));\ncurl_setopt($session, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($session, CURLOPT_CUSTOMREQUEST, 'PUT');\ncurl_setopt($session, CURLOPT_RETURNTRANSFER, true);\n// curl_setopt($session, CURLOPT_SSL_VERIFYPEER, );\n// curl_setopt($session, CURLOPT_SSL_VERIFYHOST, );\n\n$response = curl_exec($session);\n\nif ($response === false) {\n # エラー処理\n echo \"cURL Error: \" . curl_error($session);\n} else {\n # APIからのデータを処理\n var_dump($response);\n}\n\ncurl_close($session);\n"
},
{
"lang": "python",
"label": "Python 3",
"source": "import requests\n\napi_key = ''\n\ncustomer_id = ''\npayment_method_id = ''\n\nurl = f'https://api.test.fincode.jp/v1/customers/{customer_id}/payment_methods/{payment_method_id}/reactivate'\nquery_params = {\n 'pay_type': 'Virtualaccount',\n}\n\n# ヘッダーを設定\nheaders = {\n 'Authorization': f'Bearer {api_key}',\n}\n\ntry:\n response = requests.put(url, headers=headers, params=query_params)\n\n # レスポンスの処理\n if response.status_code == 200:\n # APIからのデータを処理\n print(f\"Success: {response.json()}\")\n else:\n # エラーの処理\n print(f\"Error: {response.json()}\")\nexcept requests.RequestException as e:\n # 通信エラーの処理\n print(f\"Request error: {e}\")\n"
},
{
"lang": "ruby",
"label": "Ruby",
"source": "require 'net/http'\nrequire 'uri'\n\nAPI_KEY = ''\nBASE_URL = 'https://api.test.fincode.jp'\n\ndef main\n customer_id = ''\n payment_method_id = ''\n \n endpoint = \"/v1/customers/#{customer_id}/payment_methods/#{payment_method_id}/reactivate\"\n query_params = {\n pay_type: 'Virtualaccount',\n }\n\n uri = URI.parse(BASE_URL + endpoint)\n uri.query = URI.encode_www_form(query_params)\n\n http = Net::HTTP.new(uri.host, uri.port)\n http.use_ssl = true\n\n # リクエストの作成\n request = Net::HTTP::Put.new(uri.request_uri)\n request['Authorization'] = \"Bearer #{API_KEY}\"\n\n # リクエストの送信\n response = http.request(request)\n\n case response\n when Net::HTTPSuccess\n puts 'SUCCESS'\n else\n puts 'ERROR'\n end\n\n # レスポンスの表示\n puts response.body\nend\n\nmain\n"
}
]
}
},
"/v1/customers/{customer_id}/payment_methods/{id}/inactivate": {
"put": {
"security": [
{
"Secret-Bearer-Auth": []
},
{
"Public-Bearer-Auth": []
},
{
"Secret-Basic-Auth": []
}
],
"operationId": "inactivateCustomerPaymentMethod",
"tags": [
"決済手段"
],
"summary": "決済手段 停止",
"description": "`customer_id`で指定した顧客に対し紐づくバーチャル口座決済手段のうち、`id`で指定したものを停止します。\n",
"parameters": [
{
"name": "customer_id",
"in": "path",
"description": "顧客ID",
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/CustomerId_schema"
}
]
},
"required": true
},
{
"name": "id",
"in": "path",
"description": "決済手段ID\\\n※ `pay_type = Card`（カード）の場合は `cs_` から始まるIDになります。\n",
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/PaymentMethodId_schema"
}
]
},
"required": true
},
{
"name": "Tenant-Shop-Id",
"in": "header",
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/schema"
}
]
},
"description": "※ 顧客情報を共有しないプラットフォームのメインショップのみ指定可\\\nテナントショップID。\\\nこのテナントショップに紐づく顧客のうち、指定したIDの顧客に紐づく決済手段からIDで指定した決済手段を削除します。\n"
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"pay_type"
],
"properties": {
"pay_type": {
"type": "string",
"minLength": 1,
"maxLength": 50,
"description": "決済種別\n\n* `Virtualaccount` - 銀行振込（バーチャル口座）\n"
}
}
}
}
}
},
"responses": {
"200": {
"description": "リクエストに成功",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CustomerPaymentMethod.Inactivating.Response"
}
}
}
},
"400": {
"description": "不正なリクエスト",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FincodeAPIError.Response"
}
}
}
}
},
"x-code-samples": [
{
"lang": "curl",
"label": "cURL",
"source": "curl \\\n -X PUT \\\n -H \"Authorization:Bearer \" \\\n'https://api.test.fincode.jp/v1/customers/{customer_id}/payment_methods/{id}/inactivate?pay_type=Virtualaccount'\n"
},
{
"lang": "node",
"label": "Node.js",
"source": "import fetch from \"node-fetch\";\n\nconst BASE_URL = \"https://api.test.fincode.jp\";\n\nconst API_KEY = \"\";\n\n(async () => {\n const customerId = \"\";\n const paymentMethodId = \"\";\n\n const queryParams = new URLSearchParams({\n pay_type: \"Virtualaccount\",\n });\n\n const endpoint = `${BASE_URL}/v1/customers/${customerId}/payment_methods/${paymentMethodId}/inactivate?${queryParams}`;\n\n const response = await fetch(endpoint, {\n method: \"PUT\",\n headers: {\n Authorization: `Bearer ${API_KEY}`,\n },\n });\n const result = await response.json();\n})();\n"
},
{
"lang": "go",
"label": "Go",
"source": "package main\n\nimport (\n\t\"fmt\"\n\t\"log\"\n\t\"net/http\"\n)\n\nfunc main() {\n\n\tapiKey := \"\"\n\n\tcustomerID := \"\"\n\tpaymentMethodID := \"\"\n\n\t// リクエストの作成\n\treq, _ := http.NewRequest(\n\t\t\"PUT\",\n\t\tfmt.Sprintf(\"https://api.test.fincode.jp/v1/customers/%s/payment_methods/%s/inactivate\", customerID, paymentMethodID),\n\t\tnil,\n\t)\n\treq.Header.Set(\"Authorization\", fmt.Sprintf(\"Bearer %s\", apiKey))\n\n\tparams := req.URL.Query()\n\tparams.Add(\"pay_type\", \"Virtualaccount\")\n\treq.URL.RawQuery = params.Encode()\n\n\t// リクエストの送信\n\tclient := &http.Client{}\n\tres, err := client.Do(req)\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\tdefer res.Body.Close()\n}\n"
},
{
"lang": "php",
"label": "PHP",
"source": "';\n\n$customerId = '';\n$paymentMethodId = '';\n\n$baseUrl = \"https://api.test.fincode.jp\";\n$endpoint = \"/v1/customers/{$customerId}/payment_methods/{$paymentMethodId}/inactivate\";\n$queryParams = [\n \"pay_type\" => \"Virtualaccount\",\n];\n\n$headers = [\n \"Authorization: Bearer \" . $apiKey,\n];\n\n$session = curl_init();\ncurl_setopt($session, CURLOPT_URL, $baseUrl . $endpoint . \"?\" . http_build_query($queryParams));\ncurl_setopt($session, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($session, CURLOPT_CUSTOMREQUEST, 'PUT');\ncurl_setopt($session, CURLOPT_RETURNTRANSFER, true);\n// curl_setopt($session, CURLOPT_SSL_VERIFYPEER, );\n// curl_setopt($session, CURLOPT_SSL_VERIFYHOST, );\n\n$response = curl_exec($session);\n\nif ($response === false) {\n # エラー処理\n echo \"cURL Error: \" . curl_error($session);\n} else {\n # APIからのデータを処理\n var_dump($response);\n}\n\ncurl_close($session);\n"
},
{
"lang": "python",
"label": "Python 3",
"source": "import requests\n\napi_key = ''\n\ncustomer_id = ''\npayment_method_id = ''\n\nurl = f'https://api.test.fincode.jp/v1/customers/{customer_id}/payment_methods/{payment_method_id}/inactivate'\nquery_params = {\n 'pay_type': 'Virtualaccount',\n}\n\n# ヘッダーを設定\nheaders = {\n 'Authorization': f'Bearer {api_key}',\n}\n\ntry:\n response = requests.put(url, headers=headers, params=query_params)\n\n # レスポンスの処理\n if response.status_code == 200:\n # APIからのデータを処理\n print(f\"Success: {response.json()}\")\n else:\n # エラーの処理\n print(f\"Error: {response.json()}\")\nexcept requests.RequestException as e:\n # 通信エラーの処理\n print(f\"Request error: {e}\")\n"
},
{
"lang": "ruby",
"label": "Ruby",
"source": "require 'net/http'\nrequire 'uri'\n\nAPI_KEY = ''\nBASE_URL = 'https://api.test.fincode.jp'\n\ndef main\n customer_id = ''\n payment_method_id = ''\n \n endpoint = \"/v1/customers/#{customer_id}/payment_methods/#{payment_method_id}/inactivate\"\n query_params = {\n pay_type: 'Virtualaccount',\n }\n\n uri = URI.parse(BASE_URL + endpoint)\n uri.query = URI.encode_www_form(query_params)\n\n http = Net::HTTP.new(uri.host, uri.port)\n http.use_ssl = true\n\n # リクエストの作成\n request = Net::HTTP::Put.new(uri.request_uri)\n request['Authorization'] = \"Bearer #{API_KEY}\"\n\n # リクエストの送信\n response = http.request(request)\n\n case response\n when Net::HTTPSuccess\n puts 'SUCCESS'\n else\n puts 'ERROR'\n end\n\n # レスポンスの表示\n puts response.body\nend\n\nmain\n"
}
]
}
},
"/v1/shops/payment_methods": {
"post": {
"security": [
{
"Secret-Bearer-Auth": []
},
{
"Secret-Basic-Auth": []
}
],
"operationId": "createShopPaymentMethod",
"tags": [
"ショップ決済手段"
],
"summary": "ショップ決済手段 登録",
"description": "ショップに紐づく決済手段（*Shop Payment Method*）を登録します。\n",
"parameters": [
{
"in": "header",
"name": "Tenant-Shop-Id",
"required": false,
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/schema"
}
]
},
"description": "※ プラットフォームのメインショップのみ指定可\\\nテナントショップID。\\\n指定したテナントショップにショップ決済手段を登録します。\n"
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"oneOf": [
{
"allOf": [
{
"$ref": "#/components/schemas/ShopPaymentMethod.PayeeAccount.Creating.Request"
}
],
"title": "銀行振込（指定口座）"
}
]
}
}
}
},
"responses": {
"200": {
"description": "リクエストに成功",
"content": {
"application/json": {
"schema": {
"oneOf": [
{
"allOf": [
{
"$ref": "#/components/schemas/ShopPaymentMethod.PayeeAccount.Creating.Response"
}
],
"title": "銀行振込（指定口座）"
}
]
}
}
}
},
"400": {
"description": "不正なリクエスト",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FincodeAPIError.Response"
}
}
}
}
},
"x-code-samples": [
{
"lang": "curl",
"label": "cURL",
"source": "curl \\\n -X POST \\\n -H \"Authorization:Bearer \" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"pay_type\": \"Payeeaccount\",\n \"display_flag\": \"1\",\n \"display_number\": \"1\",\n \"payee_account\": {\n \"bank_code\": \"0001\",\n \"branch_code\": \"001\",\n \"account_type\": \"1\",\n \"account_number\": \"1234567\",\n \"account_name\": \"株式会社アイウエオ\",\n \"account_name_kana\": \"ｶﾌﾞｼｷｶﾞｲｼｬｱｲｳｴｵ\"\n }\n}' \\\n 'https://api.test.fincode.jp/v1/shops/payment_methods'\n"
},
{
"lang": "node",
"label": "Node.js",
"source": "import fetch from \"node-fetch\";\n\nconst BASE_URL = \"https://api.test.fincode.jp\";\nconst API_KEY = \"\";\n\n(async () => {\n const endpoint = `${BASE_URL}/v1/shops/payment_methods`;\n\n const response = await fetch(endpoint, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${API_KEY}`,\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify({\n pay_type: \"Payeeaccount\",\n display_flag: \"1\",\n display_number: \"1\",\n payee_account: {\n bank_code: \"0001\",\n branch_code: \"001\",\n account_type: \"1\",\n account_number: \"1234567\",\n account_name: \"株式会社アイウエオ\",\n account_name_kana: \"ｶﾌﾞｼｷｶﾞｲｼｬｱｲｳｴｵ\",\n },\n }),\n });\n\n if (!response.ok) {\n console.error(`Error: ${response.statusText}`);\n return;\n }\n\n const data = await response.json();\n console.log(data);\n})();\n"
},
{
"lang": "go",
"label": "Go",
"source": "package main\n\nimport (\n\t\"bytes\"\n\t\"fmt\"\n\t\"io\"\n\t\"log\"\n\t\"net/http\"\n)\n\nfunc main() {\n\tapiKey := \"\"\n\n\turl := \"https://api.test.fincode.jp/v1/shops/payment_methods\"\n\n\treqBody := bytes.NewBufferString(`{\n\t\t\"pay_type\": \"Payeeaccount\",\n\t\t\"display_flag\": \"1\",\n\t\t\"display_number\": \"1\",\n\t\t\"payee_account\": {\n\t\t\t\"bank_code\": \"0001\",\n\t\t\t\"branch_code\": \"001\",\n\t\t\t\"account_type\": \"1\",\n\t\t\t\"account_number\": \"1234567\",\n\t\t\t\"account_name\": \"株式会社アイウエオ\",\n\t\t\t\"account_name_kana\": \"ｶﾌﾞｼｷｶﾞｲｼｬｱｲｳｴｵ\"\n\t\t}\n\t}`)\n\n\treq, err := http.NewRequest(\"POST\", url, reqBody)\n\tif err != nil {\n\t\tlog.Fatalf(\"リクエスト作成エラー: %v\", err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+apiKey)\n\treq.Header.Set(\"Content-Type\", \"application/json\")\n\n\tresp, err := http.DefaultClient.Do(req)\n\tif err != nil {\n\t\tlog.Fatalf(\"リクエスト送信エラー: %v\", err)\n\t}\n\tdefer resp.Body.Close()\n\n\trespBody, _ := io.ReadAll(resp.Body)\n\tfmt.Println(string(respBody))\n}\n"
},
{
"lang": "php",
"label": "PHP",
"source": "';\n$baseUrl = \"https://api.test.fincode.jp\";\n$endpoint = \"/v1/shops/payment_methods\";\n$headers = [\n \"Authorization: Bearer \" . $apiKey,\n \"Content-Type: application/json\"\n];\n\n$data = json_encode([\n \"pay_type\" => \"Payeeaccount\",\n \"display_flag\" => \"1\",\n \"display_number\" => \"1\",\n \"payee_account\" => [\n \"bank_code\" => \"0001\",\n \"branch_code\" => \"001\",\n \"account_type\" => \"1\",\n \"account_number\" => \"1234567\",\n \"account_name\" => \"株式会社アイウエオ\",\n \"account_name_kana\" => \"ｶﾌﾞｼｷｶﾞｲｼｬｱｲｳｴｵ\"\n ]\n]);\n\n$session = curl_init();\ncurl_setopt($session, CURLOPT_URL, $baseUrl . $endpoint);\ncurl_setopt($session, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($session, CURLOPT_CUSTOMREQUEST, \"POST\");\ncurl_setopt($session, CURLOPT_POSTFIELDS, $data);\ncurl_setopt($session, CURLOPT_RETURNTRANSFER, true);\n\n$response = curl_exec($session);\nif ($response === false) {\n echo \"cURL Error: \" . curl_error($session);\n} else {\n var_dump($response);\n}\ncurl_close($session);\n"
},
{
"lang": "python",
"label": "Python 3",
"source": "import requests\n\napi_key = ''\nurl = 'https://api.test.fincode.jp/v1/shops/payment_methods'\n\nheaders = {\n 'Authorization': f'Bearer {api_key}',\n 'Content-Type': 'application/json'\n}\n\ndata = {\n \"pay_type\": \"Payeeaccount\",\n \"display_flag\": \"1\",\n \"display_number\": \"1\",\n \"payee_account\": {\n \"bank_code\": \"0001\",\n \"branch_code\": \"001\",\n \"account_type\": \"1\",\n \"account_number\": \"1234567\",\n \"account_name\": \"株式会社アイウエオ\",\n \"account_name_kana\": \"ｶﾌﾞｼｷｶﾞｲｼｬｱｲｳｴｵ\"\n }\n}\n\ntry:\n response = requests.post(url, headers=headers, json=data)\n if response.status_code == 200:\n print(f\"Success: {response.json()}\")\n else:\n print(f\"Error: {response.json()}\")\nexcept requests.RequestException as e:\n print(f\"通信エラー: {e}\")\n"
},
{
"lang": "ruby",
"label": "Ruby",
"source": "require 'net/http'\nrequire 'uri'\nrequire 'json'\n\nAPI_KEY = ''\nBASE_URL = 'https://api.test.fincode.jp'\n\ndef main\n endpoint = '/v1/shops/payment_methods'\n uri = URI.parse(BASE_URL + endpoint)\n\n http = Net::HTTP.new(uri.host, uri.port)\n http.use_ssl = true\n\n data = {\n pay_type: \"Payeeaccount\",\n display_flag: \"1\",\n display_number: \"1\",\n payee_account: {\n bank_code: \"0001\",\n branch_code: \"001\",\n account_type: \"1\",\n account_number: \"1234567\",\n account_name: \"株式会社アイウエオ\",\n account_name_kana: \"ｶﾌﾞｼｷｶﾞｲｼｬｱｲｳｴｵ\"\n }\n }\n\n request = Net::HTTP::Post.new(uri.request_uri)\n request['Authorization'] = \"Bearer #{API_KEY}\"\n request['Content-Type'] = 'application/json'\n request.body = data.to_json\n\n response = http.request(request)\n puts response.body\nend\n\nmain\n"
}
]
},
"get": {
"security": [
{
"Secret-Bearer-Auth": []
},
{
"Secret-Basic-Auth": []
}
],
"operationId": "retrieveShopPaymentMethodList",
"tags": [
"ショップ決済手段"
],
"summary": "ショップ決済手段 一覧取得",
"description": "ショップに紐づくショップ決済手段の一覧を取得します。\n",
"parameters": [
{
"in": "header",
"name": "Tenant-Shop-Id",
"required": false,
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/schema"
}
]
},
"description": "※ プラットフォームのメインショップのみ指定可\\\nテナントショップID。\\\n指定したテナントショップに紐づくショップ決済手段の一覧を取得します。\n"
},
{
"name": "クエリ",
"in": "query",
"required": true,
"schema": {
"oneOf": [
{
"allOf": [
{
"$ref": "#/components/schemas/ShopPaymentMethod.ListRetrieving.QueryParams"
},
{
"$ref": "#/components/schemas/ShopPaymentMethod.ListRetrieving.PayeeAccount.QueryParams"
},
{
"$ref": "#/components/schemas/Pagination.QueryParams"
}
],
"title": "銀行振込（指定口座）"
}
]
},
"description": "ショップ決済手段の一覧取得において検索条件となるクエリパラメータ\n"
}
],
"responses": {
"200": {
"description": "リクエストに成功",
"content": {
"application/json": {
"schema": {
"oneOf": [
{
"allOf": [
{
"$ref": "#/components/schemas/ShopPaymentMethod.PayeeAccount.ListRetrieving.Response"
}
],
"title": "銀行振込（指定口座）"
}
]
}
}
}
},
"400": {
"description": "不正なリクエスト",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FincodeAPIError.Response"
}
}
}
}
},
"x-code-samples": [
{
"lang": "curl",
"label": "cURL",
"source": "curl \\\n -X GET \\\n -H \"Authorization:Bearer \" \\\n -H \"Content-Type: application/json\" \\\n 'https://api.test.fincode.jp/v1/shops/payment_methods?pay_type=Payeeaccount'\n"
},
{
"lang": "node",
"label": "Node.js",
"source": "import fetch from \"node-fetch\";\n\nconst BASE_URL = \"https://api.test.fincode.jp\";\nconst API_KEY = \"\";\n\n(async () => {\n const endpoint = `${BASE_URL}/v1/shops/payment_methods?pay_type=Payeeaccount`;\n\n const response = await fetch(endpoint, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${API_KEY}`,\n \"Content-Type\": \"application/json\",\n },\n });\n\n if (!response.ok) {\n console.error(`Error: ${response.statusText}`);\n return;\n }\n\n const data = await response.json();\n console.log(data);\n})();\n"
},
{
"lang": "go",
"label": "Go",
"source": "package main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"log\"\n\t\"net/http\"\n)\n\nfunc main() {\n\tapiKey := \"\"\n\n\turl := \"https://api.test.fincode.jp/v1/shops/payment_methods?pay_type=Payeeaccount\"\n\n\treq, err := http.NewRequest(\"GET\", url, nil)\n\tif err != nil {\n\t\tlog.Fatalf(\"リクエスト作成エラー: %v\", err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+apiKey)\n\treq.Header.Set(\"Content-Type\", \"application/json\")\n\n\tresp, err := http.DefaultClient.Do(req)\n\tif err != nil {\n\t\tlog.Fatalf(\"リクエスト送信エラー: %v\", err)\n\t}\n\tdefer resp.Body.Close()\n\n\trespBody, _ := io.ReadAll(resp.Body)\n\tfmt.Println(string(respBody))\n}\n"
},
{
"lang": "php",
"label": "PHP",
"source": "';\n$baseUrl = \"https://api.test.fincode.jp\";\n$endpoint = \"/v1/shops/payment_methods?pay_type=Payeeaccount\";\n$headers = [\n \"Authorization: Bearer \" . $apiKey,\n \"Content-Type: application/json\"\n];\n\n$session = curl_init();\ncurl_setopt($session, CURLOPT_URL, $baseUrl . $endpoint);\ncurl_setopt($session, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($session, CURLOPT_CUSTOMREQUEST, \"GET\");\ncurl_setopt($session, CURLOPT_RETURNTRANSFER, true);\n\n$response = curl_exec($session);\nif ($response === false) {\n echo \"cURL Error: \" . curl_error($session);\n} else {\n var_dump($response);\n}\ncurl_close($session);\n"
},
{
"lang": "python",
"label": "Python 3",
"source": "import requests\n\napi_key = ''\nurl = 'https://api.test.fincode.jp/v1/shops/payment_methods?pay_type=Payeeaccount'\n\nheaders = {\n 'Authorization': f'Bearer {api_key}',\n 'Content-Type': 'application/json'\n}\n\ntry:\n response = requests.get(url, headers=headers)\n if response.status_code == 200:\n print(f\"Success: {response.json()}\")\n else:\n print(f\"Error: {response.json()}\")\nexcept requests.RequestException as e:\n print(f\"通信エラー: {e}\")\n"
},
{
"lang": "ruby",
"label": "Ruby",
"source": "require 'net/http'\nrequire 'uri'\nrequire 'json'\n\nAPI_KEY = ''\nBASE_URL = 'https://api.test.fincode.jp'\n\ndef main\n endpoint = '/v1/shops/payment_methods?pay_type=Payeeaccount'\n uri = URI.parse(BASE_URL + endpoint)\n\n http = Net::HTTP.new(uri.host, uri.port)\n http.use_ssl = true\n\n request = Net::HTTP::Get.new(uri.request_uri)\n request['Authorization'] = \"Bearer #{API_KEY}\"\n request['Content-Type'] = 'application/json'\n\n response = http.request(request)\n puts response.body\nend\n\nmain\n"
}
]
}
},
"/v1/shops/payment_methods/{id}": {
"get": {
"security": [
{
"Secret-Bearer-Auth": []
},
{
"Secret-Basic-Auth": []
}
],
"operationId": "retrieveShopPaymentMethod",
"tags": [
"ショップ決済手段"
],
"summary": "ショップ決済手段 取得",
"description": "IDで指定したショップ決済手段を取得します。\n",
"parameters": [
{
"name": "id",
"in": "path",
"description": "ショップ決済手段ID",
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/ShopPaymentMethodId_schema"
}
]
},
"required": true
},
{
"in": "header",
"name": "Tenant-Shop-Id",
"required": false,
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/schema"
}
]
},
"description": "※ プラットフォームのメインショップのみ指定可\\\nテナントショップID。\\\nこのテナントショップに紐づくショップ決済手段のうち、指定したIDのものを取得します。\n"
},
{
"name": "クエリ",
"in": "query",
"required": true,
"schema": {
"oneOf": [
{
"allOf": [
{
"$ref": "#/components/schemas/ShopPaymentMethod.Retrieving.QueryParams"
}
],
"title": "銀行振込（指定口座）"
}
]
},
"description": "ショップ決済手段の取得において検索条件となるクエリパラメータ\n"
}
],
"responses": {
"200": {
"description": "リクエストに成功",
"content": {
"application/json": {
"schema": {
"oneOf": [
{
"allOf": [
{
"$ref": "#/components/schemas/ShopPaymentMethod.PayeeAccount.Retrieving.Response"
}
],
"title": "銀行振込（指定口座）"
}
]
}
}
}
},
"400": {
"description": "不正なリクエスト",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FincodeAPIError.Response"
}
}
}
}
},
"x-code-samples": [
{
"lang": "curl",
"label": "cURL",
"source": "curl \\\n -X GET \\\n -H \"Authorization:Bearer \" \\\n -H \"Content-Type: application/json\" \\\n 'https://api.test.fincode.jp/v1/shops/payment_methods/pm_xxxxxxxxxxxxxxxxxxxxxx?pay_type=Payeeaccount'\n"
},
{
"lang": "node",
"label": "Node.js",
"source": "import fetch from \"node-fetch\";\n\nconst BASE_URL = \"https://api.test.fincode.jp\";\nconst API_KEY = \"\";\n\n(async () => {\n const id = \"\"; // 適切な ID に置き換えてください\n const endpoint = `${BASE_URL}/v1/shops/payment_methods/${id}?pay_type=Payeeaccount`;\n\n const response = await fetch(endpoint, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${API_KEY}`,\n \"Content-Type\": \"application/json\",\n },\n });\n\n if (!response.ok) {\n console.error(`Error: ${response.statusText}`);\n return;\n }\n\n const data = await response.json();\n console.log(data);\n})();\n"
},
{
"lang": "go",
"label": "Go",
"source": "package main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"log\"\n\t\"net/http\"\n)\n\nfunc main() {\n\tapiKey := \"\"\n\tid := \"\"\n\turl := fmt.Sprintf(\"https://api.test.fincode.jp/v1/shops/payment_methods/%s?pay_type=Payeeaccount\", id)\n\n\treq, err := http.NewRequest(\"GET\", url, nil)\n\tif err != nil {\n\t\tlog.Fatalf(\"リクエスト作成エラー: %v\", err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+apiKey)\n\treq.Header.Set(\"Content-Type\", \"application/json\")\n\n\tresp, err := http.DefaultClient.Do(req)\n\tif err != nil {\n\t\tlog.Fatalf(\"リクエスト送信エラー: %v\", err)\n\t}\n\tdefer resp.Body.Close()\n\n\trespBody, _ := io.ReadAll(resp.Body)\n\tfmt.Println(string(respBody))\n}\n"
},
{
"lang": "php",
"label": "PHP",
"source": "';\n$id = \"\";\n$baseUrl = \"https://api.test.fincode.jp\";\n$endpoint = \"/v1/shops/payment_methods/{$id}?pay_type=Payeeaccount\";\n$headers = [\n \"Authorization: Bearer \" . $apiKey,\n \"Content-Type: application/json\"\n];\n\n$session = curl_init();\ncurl_setopt($session, CURLOPT_URL, $baseUrl . $endpoint);\ncurl_setopt($session, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($session, CURLOPT_CUSTOMREQUEST, \"GET\");\ncurl_setopt($session, CURLOPT_RETURNTRANSFER, true);\n\n$response = curl_exec($session);\nif ($response === false) {\n echo \"cURL Error: \" . curl_error($session);\n} else {\n var_dump($response);\n}\ncurl_close($session);\n"
},
{
"lang": "python",
"label": "Python 3",
"source": "import requests\n\napi_key = ''\nid = ''\nurl = f'https://api.test.fincode.jp/v1/shops/payment_methods/{id}?pay_type=Payeeaccount'\n\nheaders = {\n 'Authorization': f'Bearer {api_key}',\n 'Content-Type': 'application/json'\n}\n\ntry:\n response = requests.get(url, headers=headers)\n if response.status_code == 200:\n print(f\"Success: {response.json()}\")\n else:\n print(f\"Error: {response.json()}\")\nexcept requests.RequestException as e:\n print(f\"通信エラー: {e}\")\n"
},
{
"lang": "ruby",
"label": "Ruby",
"source": "require 'net/http'\nrequire 'uri'\nrequire 'json'\n\nAPI_KEY = ''\nBASE_URL = 'https://api.test.fincode.jp'\n\ndef main\n id = ''\n endpoint = \"/v1/shops/payment_methods/#{id}?pay_type=Payeeaccount\"\n uri = URI.parse(BASE_URL + endpoint)\n\n http = Net::HTTP.new(uri.host, uri.port)\n http.use_ssl = true\n\n request = Net::HTTP::Get.new(uri.request_uri)\n request['Authorization'] = \"Bearer #{API_KEY}\"\n request['Content-Type'] = 'application/json'\n\n response = http.request(request)\n puts response.body\nend\n\nmain\n"
}
]
},
"put": {
"security": [
{
"Secret-Bearer-Auth": []
},
{
"Secret-Basic-Auth": []
}
],
"operationId": "updateShopPaymentMethod",
"tags": [
"ショップ決済手段"
],
"summary": "ショップ決済手段 更新",
"description": "IDで指定したショップ決済手段を更新します。\n",
"parameters": [
{
"name": "id",
"in": "path",
"description": "ショップ決済手段ID",
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/ShopPaymentMethodId_schema"
}
]
},
"required": true
},
{
"in": "header",
"name": "Tenant-Shop-Id",
"required": false,
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/schema"
}
]
},
"description": "※ プラットフォームのメインショップのみ指定可\\\nテナントショップID。\\\nこのテナントショップに紐づくショップ決済手段のうち、指定したIDのものを更新します。\n"
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"oneOf": [
{
"allOf": [
{
"$ref": "#/components/schemas/ShopPaymentMethod.PayeeAccount.Updating.Request"
}
],
"title": "銀行振込（指定口座）"
}
]
}
}
}
},
"responses": {
"200": {
"description": "リクエストに成功",
"content": {
"application/json": {
"schema": {
"oneOf": [
{
"allOf": [
{
"$ref": "#/components/schemas/ShopPaymentMethod.PayeeAccount.Updating.Response"
}
],
"title": "銀行振込（指定口座）"
}
]
}
}
}
},
"400": {
"description": "不正なリクエスト",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FincodeAPIError.Response"
}
}
}
}
},
"x-code-samples": [
{
"lang": "curl",
"label": "cURL",
"source": "curl \\\n -X PUT \\\n -H \"Authorization:Bearer \" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"pay_type\": \"Payeeaccount\",\n \"display_flag\": \"1\",\n \"display_number\": \"1\",\n \"client_field_1\": \"備考1\"\n}' \\\n 'https://api.test.fincode.jp/v1/shops/payment_methods/pm_xxxxxxxxxxxxxxxxxxxxxx'\n"
},
{
"lang": "node",
"label": "Node.js",
"source": "import fetch from \"node-fetch\";\n\nconst BASE_URL = \"https://api.test.fincode.jp\";\nconst API_KEY = \"\";\n\n(async () => {\n const id = \"\";\n const endpoint = `${BASE_URL}/v1/shops/payment_methods/${id}`;\n\n const response = await fetch(endpoint, {\n method: \"PUT\",\n headers: {\n Authorization: `Bearer ${API_KEY}`,\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify({\n pay_type: \"Payeeaccount\",\n display_flag: \"1\",\n display_number: \"1\",\n client_field_1: \"備考1\",\n }),\n });\n\n if (!response.ok) {\n console.error(`Error: ${response.statusText}`);\n return;\n }\n\n const data = await response.json();\n console.log(data);\n})();\n"
},
{
"lang": "go",
"label": "Go",
"source": "package main\n\nimport (\n\t\"bytes\"\n\t\"fmt\"\n\t\"io\"\n\t\"log\"\n\t\"net/http\"\n)\n\nfunc main() {\n\tapiKey := \"\"\n\tid := \"\"\n\n\turl := fmt.Sprintf(\"https://api.test.fincode.jp/v1/shops/payment_methods/%s\", id)\n\n\treqBody := bytes.NewBufferString(`{\n\t\t\"pay_type\": \"Payeeaccount\",\n\t\t\"display_flag\": \"1\",\n\t\t\"display_number\": \"1\",\n\t\t\"client_field_1\": \"備考1\"\n\t}`)\n\n\treq, err := http.NewRequest(\"PUT\", url, reqBody)\n\tif err != nil {\n\t\tlog.Fatalf(\"リクエスト作成エラー: %v\", err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+apiKey)\n\treq.Header.Set(\"Content-Type\", \"application/json\")\n\n\tresp, err := http.DefaultClient.Do(req)\n\tif err != nil {\n\t\tlog.Fatalf(\"リクエスト送信エラー: %v\", err)\n\t}\n\tdefer resp.Body.Close()\n\n\trespBody, _ := io.ReadAll(resp.Body)\n\tfmt.Println(string(respBody))\n}\n"
},
{
"lang": "php",
"label": "PHP",
"source": "';\n$id = \"\";\n$baseUrl = \"https://api.test.fincode.jp\";\n$endpoint = \"/v1/shops/payment_methods/{$id}\";\n$headers = [\n \"Authorization: Bearer \" . $apiKey,\n \"Content-Type: application/json\"\n];\n\n$data = json_encode([\n \"pay_type\" => \"Payeeaccount\",\n \"display_flag\" => \"1\",\n \"display_number\" => \"1\",\n \"client_field_1\" => \"備考1\"\n]);\n\n$session = curl_init();\ncurl_setopt($session, CURLOPT_URL, $baseUrl . $endpoint);\ncurl_setopt($session, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($session, CURLOPT_CUSTOMREQUEST, \"PUT\");\ncurl_setopt($session, CURLOPT_POSTFIELDS, $data);\ncurl_setopt($session, CURLOPT_RETURNTRANSFER, true);\n\n$response = curl_exec($session);\nif ($response === false) {\n echo \"cURL Error: \" . curl_error($session);\n} else {\n var_dump($response);\n}\ncurl_close($session);\n"
},
{
"lang": "python",
"label": "Python 3",
"source": "import requests\n\napi_key = ''\nid = ''\nurl = f'https://api.test.fincode.jp/v1/shops/payment_methods/{id}'\n\nheaders = {\n 'Authorization': f'Bearer {api_key}',\n 'Content-Type': 'application/json'\n}\n\ndata = {\n \"pay_type\": \"Payeeaccount\",\n \"display_flag\": \"1\",\n \"display_number\": \"1\",\n \"client_field_1\": \"備考1\"\n}\n\ntry:\n response = requests.put(url, headers=headers, json=data)\n if response.status_code == 200:\n print(f\"Success: {response.json()}\")\n else:\n print(f\"Error: {response.json()}\")\nexcept requests.RequestException as e:\n print(f\"通信エラー: {e}\")\n"
},
{
"lang": "ruby",
"label": "Ruby",
"source": "require 'net/http'\nrequire 'uri'\nrequire 'json'\n\nAPI_KEY = ''\nBASE_URL = 'https://api.test.fincode.jp'\n\ndef main\n id = ''\n endpoint = \"/v1/shops/payment_methods/#{id}\"\n uri = URI.parse(BASE_URL + endpoint)\n\n http = Net::HTTP.new(uri.host, uri.port)\n http.use_ssl = true\n\n data = {\n pay_type: \"Payeeaccount\",\n display_flag: \"1\",\n display_number: \"1\",\n client_field_1: \"備考1\"\n }\n\n request = Net::HTTP::Put.new(uri.request_uri)\n request['Authorization'] = \"Bearer #{API_KEY}\"\n request['Content-Type'] = 'application/json'\n request.body = data.to_json\n\n response = http.request(request)\n puts response.body\nend\n\nmain\n"
}
]
},
"delete": {
"security": [
{
"Secret-Bearer-Auth": []
},
{
"Secret-Basic-Auth": []
}
],
"operationId": "deleteShopPaymentMethod",
"tags": [
"ショップ決済手段"
],
"summary": "ショップ決済手段 削除",
"description": "IDで指定したショップ決済手段を削除します。\n",
"parameters": [
{
"name": "id",
"in": "path",
"description": "ショップ決済手段ID",
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/ShopPaymentMethodId_schema"
}
]
},
"required": true
},
{
"in": "header",
"name": "Tenant-Shop-Id",
"required": false,
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/schema"
}
]
},
"description": "※ プラットフォームのメインショップのみ指定可\\\nテナントショップID。\\\nこのテナントショップに紐づくショップ決済手段のうち、指定したIDのものを削除します。\n"
},
{
"in": "query",
"name": "pay_type",
"schema": {
"allOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 50,
"description": "決済種別\n* `Payeeaccount` - 銀行振込（指定口座）\n"
}
]
},
"required": true
}
],
"responses": {
"200": {
"description": "リクエストに成功",
"content": {
"application/json": {
"schema": {
"oneOf": [
{
"allOf": [
{
"$ref": "#/components/schemas/ShopPaymentMethod.PayeeAccount.Deleting.Response"
}
],
"title": "銀行振込（指定口座）"
}
]
}
}
}
},
"400": {
"description": "不正なリクエスト",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FincodeAPIError.Response"
}
}
}
}
},
"x-code-samples": [
{
"lang": "curl",
"label": "cURL",
"source": "curl \\\n -X DELETE \\\n -H \"Authorization:Bearer \" \\\n -H \"Content-Type: application/json\" \\\n 'https://api.test.fincode.jp/v1/shops/payment_methods/pm_xxxxxxxxxxxxxxxxxxxxxx?pay_type=Payeeaccount'\n"
},
{
"lang": "node",
"label": "Node.js",
"source": "import fetch from \"node-fetch\";\n\nconst BASE_URL = \"https://api.test.fincode.jp\";\nconst API_KEY = \"\";\n\n(async () => {\n const id = \"\";\n const endpoint = `${BASE_URL}/v1/shops/payment_methods/${id}?pay_type=Payeeaccount`;\n\n const response = await fetch(endpoint, {\n method: \"DELETE\",\n headers: {\n Authorization: `Bearer ${API_KEY}`,\n \"Content-Type\": \"application/json\",\n },\n });\n\n if (!response.ok) {\n console.error(`Error: ${response.statusText}`);\n return;\n }\n\n const data = await response.json();\n console.log(data);\n})();\n"
},
{
"lang": "go",
"label": "Go",
"source": "package main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"log\"\n\t\"net/http\"\n)\n\nfunc main() {\n\tapiKey := \"\"\n\tid := \"\"\n\turl := fmt.Sprintf(\"https://api.test.fincode.jp/v1/shops/payment_methods/%s?pay_type=Payeeaccount\", id)\n\n\treq, err := http.NewRequest(\"DELETE\", url, nil)\n\tif err != nil {\n\t\tlog.Fatalf(\"リクエスト作成エラー: %v\", err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+apiKey)\n\treq.Header.Set(\"Content-Type\", \"application/json\")\n\n\tresp, err := http.DefaultClient.Do(req)\n\tif err != nil {\n\t\tlog.Fatalf(\"リクエスト送信エラー: %v\", err)\n\t}\n\tdefer resp.Body.Close()\n\n\trespBody, _ := io.ReadAll(resp.Body)\n\tfmt.Println(string(respBody))\n}\n"
},
{
"lang": "php",
"label": "PHP",
"source": "';\n$id = \"\";\n$baseUrl = \"https://api.test.fincode.jp\";\n$endpoint = \"/v1/shops/payment_methods/{$id}?pay_type=Payeeaccount\";\n$headers = [\n \"Authorization: Bearer \" . $apiKey,\n \"Content-Type: application/json\"\n];\n\n$session = curl_init();\ncurl_setopt($session, CURLOPT_URL, $baseUrl . $endpoint);\ncurl_setopt($session, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($session, CURLOPT_CUSTOMREQUEST, \"DELETE\");\ncurl_setopt($session, CURLOPT_RETURNTRANSFER, true);\n\n$response = curl_exec($session);\nif ($response === false) {\n echo \"cURL Error: \" . curl_error($session);\n} else {\n var_dump($response);\n}\ncurl_close($session);\n"
},
{
"lang": "python",
"label": "Python 3",
"source": "import requests\n\napi_key = ''\nid = ''\nurl = f'https://api.test.fincode.jp/v1/shops/payment_methods/{id}?pay_type=Payeeaccount'\n\nheaders = {\n 'Authorization': f'Bearer {api_key}',\n 'Content-Type': 'application/json'\n}\n\ntry:\n response = requests.delete(url, headers=headers)\n if response.status_code == 200:\n print(f\"Success: {response.json()}\")\n else:\n print(f\"Error: {response.json()}\")\nexcept requests.RequestException as e:\n print(f\"通信エラー: {e}\")\n"
},
{
"lang": "ruby",
"label": "Ruby",
"source": "require 'net/http'\nrequire 'uri'\nrequire 'json'\n\nAPI_KEY = ''\nBASE_URL = 'https://api.test.fincode.jp'\n\ndef main\n id = '