Customerの作成

POSThttps://api.omise.co/customers

継続請求のために決済手段を保存するCustomerプロファイルを作成します。Customerは複数のカードを保存でき、カード詳細を再入力することなく将来の購入を行うことができます。

---

🔑API認証情報

▼

---

リクエストパラメータ

推奨 - 2フィールド推奨パラメータ

▼

`email`STRING(optional)

Customerのメールアドレスです。領収書、返金通知、サポート用に使用されます。

Example:"john@example.com"

`description`STRING(optional)

Customerの名前または説明です。ダッシュボードとレポートでCustomerを識別するのに役立ちます。

Example:"John Doe"

追加 - 2フィールド追加パラメータ

▼

---

レスポンス

200

Customerが正常に作成されました

Customerプロファイルが作成されました。Customer IDは将来の課金のためにデータベースに保存する必要があります。

Customerオブジェクトのフィールド:

• id - Customer ID (cust_*)です。これをデータベースに保存してください。
• email - Customerのメールアドレスです。
• description - Customerの説明/名前です。
• default_card - デフォルトの決済cardのID（cardが提供された場合）です。
• cards - 保存されたすべてのcardを含むlistオブジェクトです。
• metadata - カスタムキーと値のデータです。

400

不正なリクエスト

リクエストの検証に失敗しました。詳細についてはエラーメッセージを確認してください。

一般的な原因:

• 無効なメール形式
• 無効なtoken ID
• metadataが15,000文字を超えています

401

認証されていません

認証に失敗しました。API keyが無効または不足しています。

一般的な原因:

• Authorizationヘッダーが不足しています
• 無効なsecret key
• secret keyではなくpublic keyを使用しています
• HTTP Basic Auth形式が正しくありません

404

見つかりません

tokenが見つからないか無効です。

一般的な原因:

• token IDが存在しません
• tokenはすでに使用されています
• tokenの有効期限が切れています

---

コードサンプル

cURL

curl https://api.omise.co/customers \
  -u skey_test_5xuy4w91xqz7d1w9u0t: \
  -d "email=john@example.com" \
  -d "description=John Doe" \
  -d "card=tokn_test_5xuy4w91xqz7d1w9u0t"

Ruby

require 'omise'

Omise.api_key = 'skey_test_5xuy4w91xqz7d1w9u0t'

customer = Omise::Customer.create({
  email: 'john@example.com',
  description: 'John Doe',
  card: 'tokn_test_5xuy4w91xqz7d1w9u0t'
})

Python

import omise

omise.api_secret = 'skey_test_5xuy4w91xqz7d1w9u0t'

customer = omise.Customer.create(
    email='john@example.com',
    description='John Doe',
    card='tokn_test_5xuy4w91xqz7d1w9u0t'
)

Node.js

const omise = require('omise')({
  secretKey: 'skey_test_5xuy4w91xqz7d1w9u0t'
});

const customer = await omise.customers.create({
  email: 'john@example.com',
  description: 'John Doe',
  card: 'tokn_test_5xuy4w91xqz7d1w9u0t'
});

PHP

<?php
define('OMISE_SECRET_KEY', 'skey_test_5xuy4w91xqz7d1w9u0t');

$customer = OmiseCustomer::create([
    'email' => 'john@example.com',
    'description' => 'John Doe',
    'card' => 'tokn_test_5xuy4w91xqz7d1w9u0t'
]);

Java

Client client = new Client.Builder()
    .secretKey("skey_test_5xuy4w91xqz7d1w9u0t")
    .build();

Customer customer = client.customers().create()
    .email("john@example.com")
    .description("John Doe")
    .card("tokn_test_5xuy4w91xqz7d1w9u0t")
    .send();

C#

var client = new Client("skey_test_5xuy4w91xqz7d1w9u0t");

var customer = await client.Customers.Create(new CreateCustomerRequest
{
    Email = "john@example.com",
    Description = "John Doe",
    Card = "tokn_test_5xuy4w91xqz7d1w9u0t"
});

Go

client, _ := omise.NewClient(
    "pkey_test_5xuy4w91xqz7d1w9u0t",
    "skey_test_5xuy4w91xqz7d1w9u0t",
)

customer, _ := client.Customers().Create(&operations.CreateCustomer{
    Email:       "john@example.com",
    Description: "John Doe",
    Card:        "tokn_test_5xuy4w91xqz7d1w9u0t",
})

---

エラーと結果コード

一般的なエラーコード

Code	Description	Resolution
bad_request	パラメータが不足または無効です	メール形式とmetadataのサイズを確認してください
authentication_failure	無効なAPI key	secret keyが正しいことを確認してください
used_token	tokenはすでに使用されています	新しいtokenを生成してください
token_not_found	token IDが存在しません	token IDが正しいことを確認してください
invalid_card	cardのtokenが無効です	tokenが正常に作成されたことを確認してください

Customerフィールド

Field	Description
id	Customer ID（データベースに保存してください）
email	Customerのメールアドレス
description	Customerの名前または説明
default_card	デフォルトの決済cardのID
cards	保存されたすべてのcardのリスト
metadata	カスタムキーと値のデータ
created_at	Customer作成のタイムスタンプ

---

お試しください

推奨 - 2項目

▼

追加 - 2項目

▼