Chargeを作成

POSThttps://api.omise.co/charges

支払いを処理するための新しいChargeを作成します。Chargeは、token（クレジットカード用）、source（代替決済方法用）、または顧客ID（保存されたカード用）を使用して作成できます。

---

🔑API認証情報

▼

---

リクエストパラメータ

必須 - 2項目必須パラメータ

▼

`amount`INTEGER(required)

最小通貨単位での金額（THBの場合はサタン、USDの場合はセント、JPYの場合は円）。例えば、100000サタン = 1,000 THBです。

Example:100000

Constraints:最小: 1（最小単位）, 最大: 支払い方法と通貨によって異なります

`currency`STRING(required)

ISO 4217の3文字通貨コード（小文字）です。

Example:"thb"

Values:thb, jpy, sgd, myr, usd, eur, gbp

必須 - 3項目中1つ支払い方法（いずれか1つが必須）

▼

`card`STRING(optional)

Omise.jsからのToken ID（例: tokn_test_...）または顧客のCard ID（例: card_test_...）です。customerとsourceが提供されていない場合は必須です。

Example:"tokn_test_5xuy4w91xqz7d1w9u0t"

`source`STRING(optional)

PromptPay、モバイルバンキング、QRコードなどの代替決済方法のSource IDです。cardとcustomerが提供されていない場合は必須です。

Example:"src_test_5xuy4w91xqz7d1w9u0t"

`customer`STRING(optional)

顧客IDです。顧客のデフォルトカードに請求します。特定のカードを指定するためにcardと組み合わせることができます。cardとsourceが提供されていない場合は必須です。

Example:"cust_test_5xuy4w91xqz7d1w9u0t"

推奨 - 5項目推奨パラメータ

▼

追加 - 5項目追加パラメータ

▼

---

レスポンス

200

トランザクション成功

Chargeが正常に作成されました。次のステップを決定するにはstatusフィールドを確認してください。

可能なChargeステータス:

• successful - 支払いが正常に完了しました。支払いを受け取りました。
• pending - Chargeはまだ承認またはキャプチャされていません。顧客のアクションを待っています。
• failed - 支払いに失敗しました。詳細についてはfailure_codeとfailure_messageを確認してください。
• reversed - Chargeが取り消されました（未キャプチャのChargeは取り消すことができます）。
• expired - 保留中のChargeが承認前に期限切れになりました。

400

不正なリクエスト

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

一般的な原因:

• 必須フィールドの欠落（amount、currency）
• 無効な通貨コード
• 支払い方法が提供されていません（card、source、またはcustomer）
• 無効な金額（最小値未満）

401

認証されていません

認証に失敗しました。無効または欠落しているAPI keyです。

一般的な原因:

• Authorizationヘッダーが欠落しています
• 無効なsecret key
• secret keyの代わりにpublic keyを使用しています
• 誤ったHTTP Basic Auth形式

402

支払いが必要です

支払い処理に失敗しました。

一般的な原因:

• 残高不足
• 発行者によってカードが拒否されました
• 期限切れのカード
• 3D Secure認証に失敗しました
• 無効なカード番号またはCVV

---

コードサンプル

cURL

curl https://api.omise.co/charges \
  -u skey_test_5xuy4w91xqz7d1w9u0t: \
  -d "amount=100000" \
  -d "currency=thb" \
  -d "card=tokn_test_5xuy4w91xqz7d1w9u0t"

Ruby

require 'omise'

Omise.api_key = 'skey_test_5xuy4w91xqz7d1w9u0t'

charge = Omise::Charge.create({
  amount: 100000,
  currency: 'thb',
  card: 'tokn_test_5xuy4w91xqz7d1w9u0t'
})

Python

import omise

omise.api_secret = 'skey_test_5xuy4w91xqz7d1w9u0t'

charge = omise.Charge.create(
    amount=100000,
    currency='thb',
    card='tokn_test_5xuy4w91xqz7d1w9u0t'
)

Node.js

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

const charge = await omise.charges.create({
  amount: 100000,
  currency: 'thb',
  card: 'tokn_test_5xuy4w91xqz7d1w9u0t'
});

PHP

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

$charge = OmiseCharge::create([
    'amount' => 100000,
    'currency' => 'thb',
    'card' => 'tokn_test_5xuy4w91xqz7d1w9u0t'
]);

Java

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

Charge charge = client.charges().create()
    .amount(100000L)
    .currency("thb")
    .card("tokn_test_5xuy4w91xqz7d1w9u0t")
    .send();

C#

var client = new Client("skey_test_5xuy4w91xqz7d1w9u0t");

var charge = await client.Charges.Create(new CreateChargeRequest
{
    Amount = 100000,
    Currency = "thb",
    Card = "tokn_test_5xuy4w91xqz7d1w9u0t"
});

Go

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

charge, _ := client.Charges().Create(&operations.CreateCharge{
    Amount:   100000,
    Currency: "thb",
    Card:     "tokn_test_5xuy4w91xqz7d1w9u0t",
})

---

エラーと結果コード

一般的なエラーコード

Code	Description	Resolution
bad_request	パラメータの欠落または無効です	すべての必須フィールドが提供されていることを確認してください
authentication_failure	無効なAPI key	secret keyが正しいことを確認してください
invalid_card	カード検証に失敗しました	カード番号、有効期限、CVVを確認してください
insufficient_funds	カードの残高が不足しています	別の支払い方法をリクエストしてください
stolen_or_lost_card	カードが紛失/盗難として報告されています	セキュリティのため支払いがブロックされました
failed_fraud_check	不正検出に失敗しました	Omiseサポートにお問い合わせください

Chargeステータスコード

Status	Description
successful	支払いが正常に完了しました
pending	顧客のアクションを待っています（例: QRコードをスキャン）
failed	支払いに失敗しました（failure_codeを参照）
reversed	Chargeがキャンセル/取り消しされました
expired	支払い前にChargeが期限切れになりました

---

試してみる

必須 - 2項目

▼

amount(必須)

currency(必須)

必須 - 3項目のうち1つ決済方法（1つ必須）

▼

card(任意)

source(任意)

customer(任意)

推奨 - 5項目

▼

追加 - 5項目

▼