INTEGRATION

Getting Started

CHARGES

Charge Types

INTEGRATION

Charge Types

In the Charge Lifecycle section, a charge, a card transaction and its lifecycle are explained. However, there could be differences in the type of charges a merchant wants to submit, and we capture these cases in the type structure.

A single charge type is composed of four distinct fields: intentcardEntryorder, and conditionally sequence. Below the possible payment scenarios are described including which fields and values are should be be set are described for each.

One-Off Charges

Online Purchases

Authorize a purchase via online check-out. Example: Goods and downloads, virtual services, event tickets, one time donation, gift card purchase.

Pre-Orders

Reserve an amount on cardholder account. Example: Booking travel or accommodation (pre-auth).

Account Status Inquiry

Check if the cardholder's account is in good standing.

One-Click (CIT)

One-off e-com transaction initiated by customer, with payment details on file.

MOTO

Authorize a purchasing via mail order or phone order. Example: Ordering a pizza using the phone with card details.

Merchandise Return

Unreferenced refund, where refund is not based on any previous authorization. Example: Cardholder returns a pair of shoes purchase, merchant agrees with refund, and cardholder provides (different) account infomation where the refund goes to.

type.intent

type.order

type.cardEntry

type.sequence

Online Purchases

purchase

checkout

e-commerce
token

-

Pre-Orders

reservation

checkout

e-commerce
token

-

Account Status Inquiry

account-status

checkout
mail/phone

e-commerce
token*
card-on-file
token-on-file

-

One-Click

purchase
reservation

one-click

card-on-file
token-on-file

-

MOTO

purchase
reservation

mail/phone

manual

-

Merchandise Return

refund

checkout

e-commerce
token
card-on-file
token-on-file

-

Standing Instruction (Recurring Charges)

Recurring (CIT)

Monthly or yearly subscriptions. Example: Subscriptions for streaming services.

Standing Order (CIT)

Regular billing based on usage. Example: Electricity, water services or cell phone usage.

Installment (CIT)

Financial arrangement that allows for the division of a larger sum into smaller, more manageable payments over a set period of time. Example: TV is purchased and it will take 5 installments for paying the full amount off.

Ucof (CIT)

Payments processed using stored card information for transactions that occur on an irregular or unscheduled basis. Example: Shared riding services or services charged ad-hoc.

Store Card (CIT)

Saving a cardholder's credit or debit card details for future transactions. Example: Store card for ride services.

type.intent

type.order

type.cardEntry

type.sequence

Recurring

purchase
reservation
account-status

recurring

e-commerce
token
card-on-file
token-on-file

initial

Standing Order

purchase
reservation
account-status

(standing)*

e-commerce
token
card-on-file
token-on-file

initial

Installment

purchase
reservation
account-status

installment

e-commerce
token
card-on-file
token-on-file

initial

Ucof

purchase
reservation

ucof

e-commerce
token
card-on-file
token-on-file

initial

Store Card

purchase
reservation
account-status

checkout

e-commerce
token

-

Industry Specific Charges

Partial Shipment/Re-Authorization (MIT)

Merchant shipping out a portion of an order while the remainder of the order is held back due to various reasons, such as stock availability issues, production delays, or logistical challenges. Each shipment is a separate transaction. Example: Consumer orders goods on marketplace from various merchants.

Delayed Charge/Incremental Auth (MIT)

A delayed charge transaction is performed to process a supplemental account charge after original services have been rendered and respective payment has been processed. Example: Hotel mini bar charge after the cardholder has checked out of hotel.

No Show Charge (MIT)

A guaranteed reservation ensures that the reservation will be honored and allows a merchant to perform a no-show transaction to charge the cardholder a penalty according to the transaction to charge the cardholder a penalty according to the... Example: Cardholder’s cancellation of a reservation without providing proper advance notice to the merchant.

Resubmission (MIT)

A merchant performs a resubmission in cases where it requested an authorization but was declined due to insufficient funds after it had already delivered the goods or services to the cardholder. Previous attempt to obtain authorization for a transaction has been declined but the issuer’s response does not prohibit the merchant from trying again later. Example: Insufficient funds, over credit limit response or transit debt recovery.

type.intent

type.order

type.cardEntry

type.sequence

Partial Shipment/
Re-authorization

purchase

(reauthorization)*

card-on-file
token-on-file

subsequent

Delayed Charge/
Incremental auth

purchase

(delayed)*

card-on-file
token-on-file

subsequent

No Show Charge

purchase

(no-show)*

card-on-file
token-on-file

subsequent

Resubmission

purchase

(resubmission)*

card-on-file
token-on-file

subsequent

Charge types indicated with an * are under development.