Charge API

The Charge API allows you to create, retrieve, and update a charge for a given amount in a given currency to a given card, customer (i.e. a customer's default card), or source. Authorized charges can be deferred for later capture, and uncaptured charges can be reversed. Custom metadata can be appended to charges.

Attribute

Name	Type	Description
object	string	The string `charge`.
id	object_id	The `CHARGE_ID` matching `/chrg(_test)?_[0-9a-z]+/`.
livemode	boolean	Whether this is a live (`true`) or test (`false`) charge.
location	string	API path to retrieve the current `charge` object.
amount	integer	Amount for charge in smallest currency unit.
authorize_uri	string	URI for payment authorization (e.g. 3-D Secure). Present only if `return_uri` was set.
authorized	boolean	Whether the charge has been authorized.
capturable	boolean	Whether the charge is able to be captured.
capture	boolean	Whether the charge is set to be auto-captured.
card	card	Card object that was charged (if a card was charged).
created	datetime	UTC datetime of the creation of the charge in ISO 8601 format (`YYYY-MM-DDThh:mm:ssZ`).
currency	string	Currency for charge as three-letter ISO 4217 code.
customer	object_id	`CUSTOMER_ID` associated with the charge.
description	string	Description of the charge.
disputable	boolean	Whether the charge is able to be disputed.
dispute	dispute	Dispute object (if charge is disputed).
failure_code	string	Failure code if `status` == `failed`. See testing for possible codes.
failure_message	string	Message describing the failure if `status` == `failed`.
funding_amount	integer	Amount fundable to the merchant after exchange to `funding_currency` (if `currency` != `funding_currency`) in the smallest currency unit.
funding_currency	string	Currency of `funding_amount`.
ip	string	Customer IP provided to Omise.
metadata	object	Custom metadata (e.g. `{"customer-id": 42}`) for charge.
paid	boolean	Whether the charge has been paid.
paid_at	datetime	UTC datetime of the charge payment in ISO 8601 format (`YYYY-MM-DDThh:mm:ssZ`).
refundable	boolean	Whether the charge is able to be refunded.
refunded	integer	Amount refunded.
refunds	list	List of refund objects.
return_uri	string	URI to which the customer is redirected after authorization (e.g. 3-D Secure in the case of cards).
reversed	boolean	Whether the charge authorization has been reversed.
reversed_at	datetime	UTC datetime of the reverse of the charge in ISO 8601 format (`YYYY-MM-DDThh:mm:ssZ`).
reversible	boolean	Whether the charge authorization is able to be reversed.
schedule	object	Schedule associated with charge.
source	source	Source that was charged (if a source was charged).
status	string	Charge status. One of `failed`, `expired`, `pending`, `reversed` or `successful`.
transaction	object_id	`TRANSACTION_ID` of charge.
voided	boolean	Whether the charge has been voided.

Deprecated Attribute

Name	Type	Description
reference	string	Charge reference code. Only if `return_uri` was set.

Example

Json Response

{
  "object": "charge",
  "id": "chrg_test_5086xlsx4lghk9bpb75",
  "livemode": false,
  "location": "/charges/chrg_test_5086xlsx4lghk9bpb75",
  "amount": 100000,
  "currency": "thb",
  "description": null,
  "capture": true,
  "authorized": true,
  "reversed": false,
  "paid": true,
  "transaction": "trxn_test_5086xltqqbv4qpmu0ri",
  "refunded": 0,
  "refunds": {
    "object": "list",
    "from": "1970-01-01T00:00:00+00:00",
    "to": "2015-06-02T05:41:49+00:00",
    "offset": 0,
    "limit": 20,
    "total": 0,
    "data": [

    ],
    "location": "/charges/chrg_test_5086xlsx4lghk9bpb75/refunds"
  },
  "failure_code": null,
  "failure_message": null,
  "card": {
    "object": "card",
    "id": "card_test_5086xl7amxfysl0ac5l",
    "livemode": false,
    "location": "/customers/cust_test_5086xleuh9ft4bn0ac2/cards/card_test_5086xl7amxfysl0ac5l",
    "country": "us",
    "city": "Bangkok",
    "postal_code": "10320",
    "financing": "",
    "last_digits": "4242",
    "brand": "Visa",
    "expiration_month": 10,
    "expiration_year": 2018,
    "fingerprint": "mKleiBfwp+PoJWB/ipngANuECUmRKjyxROwFW5IO7TM=",
    "name": "Somchai Prasert",
    "security_code_check": true,
    "created": "2015-06-02T05:41:46Z"
  },
  "customer": "cust_test_5086xleuh9ft4bn0ac2",
  "ip": null,
  "dispute": null,
  "created": "2015-06-02T05:41:49Z"
}

List all charges

- GET https://api.omise.co/charges

Returns a list of all charge objects belonging to your account.

Request Parameter

Name	Type	Description
offset	integer	(optional, default: 0) Offset of the first record returned (i.e. how many records to skip from the beginning).
limit	integer	(optional, default: 20, maximum: 100) Number of records to return.
from	datetime	(optional, default: `1970-01-01T00:00:00Z`) Earliest UTC date and time for returned records in ISO 8601 format (`YYYY-MM-DDThh:mm:ssZ`).
to	datetime	(optional, default: current UTC datetime) Latest UTC datetime for returned records in ISO 8601 format (`YYYY-MM-DDThh:mm:ssZ`).
order	string	(optional, default: `chronological`) Order in which to return records. One of `chronological` (earliest to latest) or `reverse_chronological` (latest to earliest).

Example

List all charges

curl
ruby
python
php
C#
node.js
java
go
elixir

curl -X GET https://api.omise.co/charges \
  -u skey_test_4xsjvwfnvb2g0l81sjz:

require "omise"

Omise.secret_api_key = "skey_test_4xs8breq3htbkj03d2x"

charges = Omise::Charge.list

import omise

omise.api_secret = 'skey_test_4xs8breq3htbkj03d2x'

charges = omise.Charge.retrieve()

<?php

$charges = OmiseCharge::retrieve();

var charges = await Client.Charges.GetList(order: Ordering.Chronological);
Console.WriteLine($"total charges: {charges.Total}");

omise.charges.list(function(error, list) {
  /* Response. */
});

ScopedList<Charge> charges = client.charges().list();
System.out.printf("returned charges: %d", charges.getData().size());
System.out.printf("total no. of charges: %d", charges.getTotal());

charges, list := &omise.ChargeList{}, &operations.ListCharges{
	operations.List{
		Limit: 100,
		From:  time.Now().Add(-1 * time.Hour),
	},
}

if e := client.Do(charges, list); e != nil {
	log.Fatalln(e)
}

log.Println("# of charges made in the last hour:", len(charges.Data))

Omise.configure(secret_key: "skey_test_4xs8breq3htbkj03d2x")

Omise.Charge.list

Create a charge

- POST https://api.omise.co/charges

Successfully posting to this endpoint will either authorize a charge on a card (for later capture) or directly capture a charge from a card or source.

In case the charge fails, this endpoint will either return one of several error objects or else a charge object with failure_code set to one of the following:

Code	Description
`insufficient_fund`	Insufficient funds in the account or the card has reached the credit limit.
`stolen_or_lost_card`	Card is stolen or lost.
`failed_processing`	Card processing has failed, you may retry this transaction.
`payment_rejected`	The payment was rejected by the issuer or the acquirer with no specific reason.
`invalid_security_code`	The security code was invalid or the card did not pass preauth.
`failed_fraud_check`	Card was marked as fraudulent.
`invalid_account_number`	This number is not attributed or has been deactivated.

When testing credit cards charges, you can make the API return the above responses using special test credit card numbers.

Request Parameter

Name	Type	Description
amount	integer	(required) Amount for charge in the smallest currency unit.
capture	boolean	(optional, default: `true`) Whether or not you want the charge to be captured immediately.
card	object_id	(optional) Unused `TOKEN_ID` or `CARD_ID`. In the case of the `CARD_ID` the customer parameter must be present and be the owner of the card. For the `TOKEN_ID`, the customer must not be passed.
currency	string	(required) Currency for the charge. If you are charging a source, the currency must match the currency specified in the source at its creation.
customer	object_id	(optional) `CUSTOMER_ID` that has at least one card already associated. By default the default card of the customer will be used. This parameter is required unless passing a `TOKEN_ID` or `SOURCE_ID` in the appropriate parameter.
description	string	(optional) Description to attach to the charge.
ip	string	(optional) IP address to attach to the charge.
metadata	object	(optional) Custom metadata (e.g. `{"customer-id": 42}`) to attach to the charge.
return_uri	string	(optional) URI to which the customer is redirected after payment authorization (e.g. 3-D Secure in the case of cards). Required if `source` is specified.
source	object_id	(optional) Valid `SOURCE_ID` or source request object.

Example

Charge a card using a token

curl
ruby
python
php
C#
node.js
java
go
elixir

curl https://api.omise.co/charges \
  -X POST \
  -u skey_test_4xsjvwfnvb2g0l81sjz: \
  -d "amount=100000" \
  -d "currency=thb" \
  -d "card=tokn_test_4xs9408a642a1htto8z"

require "omise"

Omise.secret_api_key = "skey_test_4xs8breq3htbkj03d2x"

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

import omise

omise.api_secret = 'skey_test_4xs8breq3htbkj03d2x'

charge = omise.Charge.create(
  amount=100000,
  currency="thb",
  card="tokn_test_4xs9408a642a1htto8z"
)

<?php

$charge = OmiseCharge::create(array(
  'amount' => 100000,
  'currency' => 'thb',
  'card' => 'tokn_test_4xs9408a642a1htto8z'
));

var token = await RetrieveToken();
var charge = await Client.Charges.Create(new CreateChargeRequest
{
    Amount = 2000,
    Currency = "thb",
    Card = token.Id,
    Metadata = new Dictionary<string, object>
    {
        { "order_id", "123" }
    },
});

Console.WriteLine($"created charge: {charge.Id}");

omise.charges.create({
  'amount': '100000',
  'currency': 'thb',
  'card': 'tokn_test_4xs9408a642a1htto8z'
}, function(err, charge) {
  /* Response. */
});

Charge charge = client.charges()
  .create(new Charge.Create()
          .amount(100000) // 1,000 THB
          .currency("thb")
          .card("tokn_test_4xs9408a642a1htto8z"));
System.out.printf("created charge: %s", charge.getId());

charge, create := &omise.Charge{}, &operations.CreateCharge{
	Amount:   204842, // THB 2,048.42
	Currency: "thb",
	Card:     "tokn_test_4xs9408a642a1htto8z",
}

if e := client.Do(charge, create); e != nil {
	log.Fatalln(e)
}

log.Printf("created charge: %#v\n", charge)

Omise.configure(secret_key: "skey_test_4xs8breq3htbkj03d2x")

Omise.Charge.create(
  amount:   100000,
  currency: "thb",
  card:     "tokn_test_4xs9408a642a1htto8z"
)

Charge a card using a customer

curl
ruby
python
php
C#
node.js
java
go
elixir

curl https://api.omise.co/charges \
  -X POST \
  -u skey_test_4xsjvwfnvb2g0l81sjz: \
  -d "amount=100000" \
  -d "currency=thb" \
  -d "customer=cust_test_4xtrb759599jsxlhkrb"

require "omise"

Omise.secret_api_key = "skey_test_4xs8breq3htbkj03d2x"

charge = Omise::Charge.create({
  amount: 100000,
  currency: "thb",
  customer: "cust_test_4xtrb759599jsxlhkrb"
})

import omise

omise.api_secret = 'skey_test_4xs8breq3htbkj03d2x'

charge = omise.Charge.create(
  amount=100000,
  currency="thb",
  customer="cust_test_4xtrb759599jsxlhkrb"
)

<?php

$charge = OmiseCharge::create(array(
  'amount' => 100000,
  'currency' => 'thb',
  'customer' => 'cust_test_4xtrb759599jsxlhkrb'
));

var customerId = "cust_test_5665swqhhb3mioax1y7";
var charge = await Client.Charges.Create(new CreateChargeRequest
{
    Amount = 2000,
    Currency = "thb",
    Customer = customerId,
});

Console.WriteLine($"created charge: {charge.Id}");

omise.charges.create({
  'amount': '100000',
  'currency': 'thb',
  'customer': 'cust_test_4xtrb759599jsxlhkrb'
}, function(error, charge) {
  /* Response. */
});

Charge charge = client.charges()
  .create(new Charge.Create()
          .amount(100000) // 1,000 THB
          .currency("thb")
          .customer("cust_test_4xtrb759599jsxlhkrb"));
System.out.printf("created charge: %s", charge.getId());

charge, create := &omise.Charge{}, &operations.CreateCharge{
	Amount:   204842, // THB 2,048.42
	Currency: "thb",
	Customer: "cust_test_4xtrb759599jsxlhkrb",
}

if e := client.Do(charge, create); e != nil {
	log.Fatalln(e)
}

log.Printf("created charge: %#v\n", charge)

Omise.configure(secret_key: "skey_test_4xs8breq3htbkj03d2x")

Omise.Charge.create(
  amount:   100000,
  currency: "thb",
  customer: "cust_test_4xtrb759599jsxlhkrb",
)

Charge a card using a customer and a card

curl
ruby
python
php
C#
node.js
java
go
elixir

curl https://api.omise.co/charges \
  -X POST \
  -u skey_test_4xsjvwfnvb2g0l81sjz: \
  -d "amount=100000" \
  -d "currency=thb" \
  -d "customer=cust_test_4xtrb759599jsxlhkrb" \
  -d "card=card_test_4xtsoy2nbfs7ujngyyq"

require "omise"

Omise.secret_api_key = "skey_test_4xs8breq3htbkj03d2x"

charge = Omise::Charge.create({
  amount: 100000,
  currency: "thb",
  customer: "cust_test_4xtrb759599jsxlhkrb",
  card: "card_test_4xtsoy2nbfs7ujngyyq"
})

import omise

omise.api_secret = 'skey_test_4xs8breq3htbkj03d2x'

charge = omise.Charge.create(
  amount=100000,
  currency="thb",
  customer="cust_test_4xtrb759599jsxlhkrb",
  card="card_test_4xtsoy2nbfs7ujngyyq"
)

<?php

$charge = OmiseCharge::create(array(
  'amount' => 100000,
  'currency' => 'thb',
  'customer' => 'cust_test_4xtrb759599jsxlhkrb',
  'card' => 'card_test_4xtsoy2nbfs7ujngyyq'
));

var customerId = "cust_test_5665swqhhb3mioax1y7";
var cardId = "card_test_5665swpkm6tv47htmuv";
var charge = await Client.Charges.Create(new CreateChargeRequest
{
    Amount = 2000,
    Currency = "thb",
    Customer = customerId,
    Card = cardId,
});

Console.WriteLine($"created charge: {charge.Id}");

omise.charges.create({
  'amount': '100000',
  'currency': 'thb',
  'customer': 'cust_test_4xtrb759599jsxlhkrb',
  'card': 'card_test_52ydv7jkwu6rp6qt96m'
}, function(error, charge) {
  /* Response. */
});

Charge charge = client.charges()
  .create(new Charge.Create()
          .amount(100000) // 1,000 THB
          .currency("thb")
          .customer("cust_test_4xtrb759599jsxlhkrb")
          .card("card_test_4xtsoy2nbfs7ujngyyq"));
System.out.printf("created charge: %s", charge.getId());

charge, create := &omise.Charge{}, &operations.CreateCharge{
	Amount:      204842, // THB 2,048.42
	Currency:    "thb",
	Description: "example charge.",
	Card:        "card_test_4xtsoy2nbfs7ujngyyq",
	Customer:    "cust_test_4xtrb759599jsxlhkrb",
}

if e := client.Do(charge, create); e != nil {
	log.Fatalln(e)
}

log.Println("created charge: %#v\n", charge)

Omise.configure(secret_key: "skey_test_4xs8breq3htbkj03d2x")

Omise.Charge.create(
  amount:   100000,
  currency: "thb",
  customer: "cust_test_4xtrb759599jsxlhkrb",
  card:     "card_test_4xtsoy2nbfs7ujngyyq"
)

Create and charge a new source

curl
ruby
python
php
C#
node.js
java
go
elixir

curl https://api.omise.co/charges \
  -X POST \
  -u skey_test_5dg6uq2y11j7i748vo8: \
  -d "amount=100000" \
  -d "currency=thb" \
  -d "return_uri=http://www.omise.co" \
  -d "source[type]=alipay"

Create an Internet Banking charge

curl
ruby
python
php
C#
node.js
java
go
elixir

curl https://api.omise.co/charges \
  -X POST \
  -u skey_test_4xs8breq3htbkj03d2x: \
  -d "amount=100000" \
  -d "currency=thb" \
  -d "return_uri=http://www.example.com" \
  -d "source=src_test_59wbyjr7jz44d8nzcd6"

require "omise"

Omise.secret_api_key = "skey_test_4xs8breq3htbkj03d2x"

charge = Omise::Charge.create({
  amount: 100000,
  currency: "thb",
  return_uri: "http://www.example.com",
  source: "src_test_59wbyjr7jz44d8nzcd6"
})

import omise

omise.api_secret = 'skey_test_4xs8breq3htbkj03d2x'

charge = omise.Charge.create(
  amount=100000,
  currency="thb",
  return_uri="http://www.example.com",
  source="src_test_59wbyjr7jz44d8nzcd6"
)

<?php

$charge = OmiseCharge::create(array(
  'amount' => 100000,
  'currency' => 'thb',
  'return_uri' => 'http://www.example.com',
  'source' => 'src_test_59wbyjr7jz44d8nzcd6'
));

var returnUri = "http://www.example.com";
var source = "src_test_59wbyjr7jz44d8nzcd6";
var charge = await Client.Charges.Create(new CreateChargeRequest
{
    Amount = 2000,
    Currency = "thb",
    ReturnUri = returnUri,
    Source = source,
});

Console.WriteLine($"created charge: {charge.Id}");

omise.charges.create({
  'amount': '100000',
  'currency': 'thb',
  'return_uri': 'http://www.example.com',
  'source': 'src_test_59wbyjr7jz44d8nzcd6'
}, function(error, charge) {
  /* Response. */
});

Charge charge = client.charges()
  .create(new Charge.Create()
          .amount(100000) // 1,000 THB
          .currency("thb")
          .returnUri("http://www.example.com")
          .source("src_test_59wbyjr7jz44d8nzcd6"));
System.out.printf("created charge: %s", charge.getId());

charge, create := &omise.Charge{}, &operations.CreateCharge{
	Amount:      204842, // THB 2,048.42
	Currency:    "thb",
	ReturnUri:   "http://www.example.com",
	Source:     "src_test_59wbyjr7jz44d8nzcd6",
}

if e := client.Do(charge, create); e != nil {
	log.Fatalln(e)
}

log.Println("created charge: %#v\n", charge)

Omise.configure(secret_key: "skey_test_4xs8breq3htbkj03d2x")

Omise.Charge.create(
  amount:   100000,
  currency: "thb",
  return_uri: "http://www.example.com",
  source: "src_test_59wbyjr7jz44d8nzcd6"
)

Create an Alipay charge

curl
ruby
python
php
C#
node.js
java
go
elixir

curl https://api.omise.co/charges \
  -X POST \
  -u skey_test_4xsjvwfnvb2g0l81sjz: \
  -d "amount=100000" \
  -d "currency=thb" \
  -d "return_uri=http://www.example.com" \
  -d "source=src_test_59wbyjr7jz44d8nzcd6"

require "omise"

Omise.secret_api_key = "skey_test_4xs8breq3htbkj03d2x"

charge = Omise::Charge.create({
  amount: 100000,
  currency: "thb",
  description: "an alipay charge",
  return_uri: "http://www.example.com",
  source: "src_test_59wbyjr7jz44d8nzcd6"
})

import omise

omise.api_secret = 'skey_test_4xs8breq3htbkj03d2x'

charge = omise.Charge.create(
  amount=100000,
  currency="thb",
  return_uri="http://www.example.com",
  source="src_test_59wbyjr7jz44d8nzcd6"
)

<?php

$charge = OmiseCharge::create(array(
  'amount' => 100000,
  'currency' => 'thb',
  'return_uri' => 'http://www.example.com',
  'source' => 'src_test_59wbyjr7jz44d8nzcd6'
));

var returnUri = "http://www.example.com";
var source = "src_test_59wbyjr7jz44d8nzcd6";
var charge = await Client.Charges.Create(new CreateChargeRequest
{
    Amount = 2000,
    Currency = "thb",
    ReturnUri = returnUri,
    Source = source,
});

Console.WriteLine($"created charge: {charge.Id}");

omise.charges.create({
  'amount': '100000',
  'currency': 'thb',
  'return_uri': 'http://www.example.com',
  'source': 'src_test_59wbyjr7jz44d8nzcd6'
}, function(error, charge) {
  /* Response. */
});

Charge charge = client.charges()
  .create(new Charge.Create()
          .amount(100000) // 1,000 THB
          .currency("thb")
          .returnUri("http://www.example.com")
          .source("src_test_59wbyjr7jz44d8nzcd6"));
System.out.printf("created charge: %s", charge.getId());

charge, create := &omise.Charge{}, &operations.CreateCharge{
	Amount:      204842, // THB 2,048.42
	Currency:    "thb",
	ReturnUri:   "http://www.example.com",
	Source:     "src_test_59wbyjr7jz44d8nzcd6",
}

if e := client.Do(charge, create); e != nil {
	log.Fatalln(e)
}

log.Println("created charge: %#v\n", charge)

Omise.configure(secret_key: "skey_test_4xs8breq3htbkj03d2x")

Omise.Charge.create(
  amount:   100000,
  currency: "thb",
  return_uri: "http://www.example.com",
  source: "src_test_59wbyjr7jz44d8nzcd6"
)

Create an Installment charge

curl
ruby
python
php
C#
node.js
java
go
elixir

# create a new installment source

curl https://api.omise.co/sources \
-X POST \
-u pkey_test_511yxv4dtvyj3xvewee: \
-d "description=Installment Payment" \
-d "amount=500000" \
-d "currency=thb" \
-d "type=installment_kbank" \
-d "installment_terms=4"

# charge the created source, replacing the value after `source=` in
# the below command with the value of `id` in the output from the
# above command

curl https://api.omise.co/charges \
-X POST \
-u skey_test_5945rfj11gmvd89as2a: \
-d "source=src_test_5bvkdbtqrp86tpvmvem" \
-d "description=Charge with source" \
-d "amount=500000" \
-d "currency=thb" \
-d "return_uri=https://merchant.website.com/"

Retrieve a charge

- GET https://api.omise.co/charges/CHARGE_ID

Example

Retrieve a charge

curl
ruby
python
php
C#
node.js
java
go
elixir

curl https://api.omise.co/charges/chrg_test_4xso2s8ivdej29pqnhz \
  -u skey_test_4xsjvwfnvb2g0l81sjz:

require "omise"

Omise.secret_api_key = "skey_test_4xs8breq3htbkj03d2x"

charge = Omise::Charge.retrieve("chrg_test_4xso2s8ivdej29pqnhz")

import omise

omise.api_secret = 'skey_test_4xs8breq3htbkj03d2x'

charge = omise.Charge.retrieve("chrg_test_4xso2s8ivdej29pqnhz")

<?php

$charge = OmiseCharge::retrieve("chrg_test_4xso2s8ivdej29pqnhz");

var chargeId = "chrg_test_58e1ybdog1y8f5z97l8";
var charge = await Client.Charges.Get(chargeId);
Console.WriteLine($"charge amount: {charge.Amount}");

omise.charges.retrieve('chrg_test_4xso2s8ivdej29pqnhz', function(error, charge) {
  /* Response. */
});

Charge charge = client.charges().get("chrg_test_4xso2s8ivdej29pqnhz");
System.out.printf("charge amount: %d", charge.getAmount());

charge, retrieve := &omise.Charge{}, &operations.RetrieveCharge{"chrg_test_4xso2s8ivdej29pqnhz"}
if e := client.Do(charge, retrieve); e != nil {
	log.Fatalln(e)
}

log.Printf("retrieved charge: %#v\n", charge)

Omise.configure(secret_key: "skey_test_4xs8breq3htbkj03d2x")

Omise.Charge.retrieve("chrg_test_4xso2s8ivdej29pqnhz")

Update a charge

- PATCH https://api.omise.co/charges/CHARGE_ID

Update a charge. At this time the only charge attributes that can be modified are its description and metadata.

Request Parameter

Name	Type	Description
description	string	(optional) Description to attach to the charge.
metadata	object	(optional) Custom metadata (e.g. `{"customer-id": 42}`) to attach to the charge.

Example

Update a charge description

curl
ruby
python
php
C#
node.js
java
go
elixir

curl https://api.omise.co/charges/chrg_test_4xso2s8ivdej29pqnhz \
  -X PATCH \
  -u skey_test_4xsjvwfnvb2g0l81sjz: \
  -d "description=Another description"

require "omise"

Omise.secret_api_key = "skey_test_4xs8breq3htbkj03d2x"

charge = Omise::Charge.retrieve("chrg_test_4xso2s8ivdej29pqnhz")
charge.update(description: "Another description")

import omise

omise.api_secret = 'skey_test_4xs8breq3htbkj03d2x'

charge = omise.Charge.retrieve("chrg_test_4xso2s8ivdej29pqnhz")
charge.update(description="Another description")

# Or alternatively:
charge.description = "Another description"
charge.update()

<?php

$charge = OmiseCharge::retrieve('chrg_test_4xso2s8ivdej29pqnhz');
$charge->update(array(
  'description' => 'Another description'
));

var charge = RetrieveUncapturedCharge();
charge = await Client.Charges.Update(charge.Id, new UpdateChargeRequest
{
    Description = "hello",
    Metadata = new Dictionary<string, object>
    {
        { "order_id", "123" },
    }
});

Console.WriteLine($"updated charge: {charge.Id} {charge.Description}");

omise.charges.update(
  'chrg_test_4xso2s8ivdej29pqnhz',
  {description: 'Another description'},
  function(error, charge) {
    /* Response. */
  }
);

Charge charge = client.charges()
  .update("chrg_test_4xso2s8ivdej29pqnhz", new Charge.Update()
          .description("updated description"));
System.out.printf("updated description: %s", charge.getDescription());

charge, update := &omise.Charge{}, &operations.UpdateCharge{
	ChargeID:    "chrg_test_4xso2s8ivdej29pqnhz",
	Description: "Made on Monday",
}

if e := client.Do(charge, update); e != nil {
	log.Fatalln(e)
}

log.Printf("updated charge: %#v\n", charge)

Omise.configure(secret_key: "skey_test_4xs8breq3htbkj03d2x")

Omise.Charge.update("chrg_test_4xso2s8ivdej29pqnhz", description: "Another description")

Capture an authorized charge

- POST https://api.omise.co/charges/CHARGE_ID/capture

If you have created a charge and passed capture=false, you'll have an authorized-only charge that can be captured anytime within 7 days. After that, the charge will expire and posting to this endpoint will result in an expired charge error. Any other failure will result in an failed capture error

Example

Capture an authorized charge

curl
ruby
python
php
C#
node.js
java
go
elixir

curl https://api.omise.co/charges/chrg_test_4xso2s8ivdej29pqnhz/capture \
  -X POST \
  -u skey_test_4xsjvwfnvb2g0l81sjz:

require "omise"

Omise.secret_api_key = "skey_test_4xs8breq3htbkj03d2x"

charge = Omise::Charge.retrieve("chrg_test_4xso2s8ivdej29pqnhz")
charge.capture

import omise

omise.api_secret = 'skey_test_4xs8breq3htbkj03d2x'

charge = omise.Charge.retrieve("chrg_test_4xso2s8ivdej29pqnhz")
charge.capture()

<?php

$charge = OmiseCharge::retrieve('chrg_test_4xso2s8ivdej29pqnhz');
$charge->capture();

var charge = RetrieveUncapturedCharge();
charge = await Client.Charges.Capture(charge.Id);
Console.WriteLine($"captured charge: ({charge.Paid}) {charge.Id}");

omise.charges.capture('chrg_test_4xso2s8ivdej29pqnhz', function(error, charge) {
  /* Response. */
});

Charge charge = client.charges().capture("chrg_test_4xso2s8ivdej29pqnhz");
System.out.printf("captured charge: %s",charge.getId());

charge, capture := &omise.Charge{}, &operations.CaptureCharge{
	ChargeID: "chrg_test_4xso2s8ivdej29pqnhz",
}

if e := client.Do(charge, capture); e != nil {
	log.Fatalln(e)
}

log.Printf("captured charge: %#v\n", charge)

Omise.configure(secret_key: "skey_test_4xs8breq3htbkj03d2x")

Omise.Charge.capture("chrg_test_4xso2s8ivdej29pqnhz")

Reverse an uncaptured charge

- POST https://api.omise.co/charges/CHARGE_ID/reverse

If you have created a charge and passed capture=false you'll have an authorized-only charge that can be reversed (i.e. the amount released), at a later time.

Example

Reverse an uncaptured charge

curl
ruby
python
php
C#
node.js
java
go
elixir

curl https://api.omise.co/charges/chrg_test_4xso2s8ivdej29pqnhz/reverse \
  -X POST \
  -u skey_test_4xsjvwfnvb2g0l81sjz:

require "omise"

Omise.secret_api_key = "skey_test_4xs8breq3htbkj03d2x"

charge = Omise::Charge.retrieve("chrg_test_4xso2s8ivdej29pqnhz")
charge.reverse

import omise

omise.api_secret = 'skey_test_4xs8breq3htbkj03d2x'

charge = omise.Charge.retrieve("chrg_test_4xso2s8ivdej29pqnhz")
charge.reverse()

$charge = OmiseCharge::retrieve('chrg_test_4xso2s8ivdej29pqnhz');
$charge->reverse();

var charge = RetrieveUncapturedCharge();
charge = await Client.Charges.Reverse(charge.Id);
Console.WriteLine($"reversed charge: ({charge.Reversed}) {charge.Id}");

omise.charges.reverse('chrg_test_4xso2s8ivdej29pqnhz', function(error, charge) {
  /* Response. */
});

Charge charge = client.charges().reverse("chrg_test_4xso2s8ivdej29pqnhz");
System.out.printf("charge reversal: %s", Boolean.toString(charge.isReversed()));

// Not available yet

Omise.configure(secret_key: "skey_test_4xs8breq3htbkj03d2x")

Omise.Charge.reverse("chrg_test_4xso2s8ivdej29pqnhz")

Mark a charge as paid in test mode

- POST https://api.omise.co/charges/CHARGE_ID/mark_as_paid

This endpoint allows you to manually mark a test charge as paid. This can be useful for testing purposes. Only charges with an "offline" payment flow (that is, charges from barcode_alipay, bill_payment_tesco_lotus, and econtext payment sources) support this feature for now.

Example

Mark a test charge as paid

curl
ruby
python
php
C#
node.js
java
go
elixir

curl https://api.omise.co/charges/chrg_test_4xso2s8ivdej29pqnhz/mark_as_paid \
  -X POST \
  -u skey_test_4xsjvwfnvb2g0l81sjz:

Mark a charge as failed in test mode

- POST https://api.omise.co/charges/CHARGE_ID/mark_as_failed

This endpoint allows you to manually mark a test charge as failed. This can be useful for testing purposes. Only charges with an "offline" payment flow (that is, charges from barcode_alipay, bill_payment_tesco_lotus, and econtext payment sources) support this feature for now.

Example

Mark a test charge as failed

curl
ruby
python
php
C#
node.js
java
go
elixir

curl https://api.omise.co/charges/chrg_test_4xso2s8ivdej29pqnhz/mark_as_failed \
  -X POST \
  -u skey_test_4xsjvwfnvb2g0l81sjz: