Issuing transactions

Learn how to use Issuing to handle transactions.

After an authorization is approved and is captured, the status on the authorization is set to closed and a Transaction object is created. This normally happens within 24 hours; however hotels, airlines, and car rental companies are able to capture up to 30 days after authorization.

When an authorization is captured, two things happen.

The status on the authorization is set to closed, releasing the purchase amount held by that authorization. A balance transaction of type issuing_authorization_release is created to represent this.
A new transaction object of type capture is created. The purchase amount is deducted from the balance you’re using for Issuing.

Spending controls, real time authorization controls, and card status (whether a card is active or not) don’t apply for capture. They can be used to determine whether authorizations are approved, but captures for approved authorizations always succeed.

Handling other transactions

In addition to regular transactions, there are a few other cases that you should be ready to handle.

Refunds are transactions with type of refund.

When we create a transaction representing a refund or credit, we try to link it to the original authorization. In some cases, like when a card has been credited rather than refunded, this isn’t possible. In these cases, the authorization field of the transaction is set to null, and the transaction won’t be linked to the authorization.

{
  "id": "ipi_1GTG10EEsyYlpYZ9VJn2xV3B",
  "object": "issuing.transaction",
  "amount": 100,
  "authorization": "iauth_1GBZQyEEsyYlpYZ9255L8GQC",
  "balance_transaction": null,
  "card": "ic_1GBZQJEEsyYlpYZ99v6rq38S",
  "cardholder": null,
  "created": 1585783834,
  "currency": "usd",
  "livemode": false,
  "merchant_amount": 100,
  "merchant_currency": "usd",
  "merchant_data": {
    "category": "taxicabs_limousines",
    "city": "San Francisco",
    "country": "US",
    "name": "Rocket Rides",
    "network_id": "1234567890",
    "postal_code": "94111",
    "state": "CA",
    "url": null
  },
  "metadata": {},
  "type": "refund",
}