logo
API Reference
No results found.
CARD
Request a card token
post
Make a charge or deferred charge
post
Void a transaction
delete
Refund a transaction
delete
Request deferred options
get
Pre-authorize payments
post
Capture a pre-authorized payment
post
Bin Info
get
Validate OTP
post
Card Subscriptions
Request a subscription token
post
Update a subscription card data
put
Make a charge on a subscription
post
Cancel a subscription
delete
Update a subscription
patch
Add a temporary charge or discount
put
Create a subscription
post
Pre-authorize payments
post
Capture a pre-authorized payment
post
Get Subscription Info
get
Transfer In
Get Bank List
get
Request a Transfer In token
post
Init Transaction
post
Get Status
get
Transfer Out
Get Bank List
get
Request a Transfer Out token
post
Init Transaction
post
Get Status
get
Void a transaction
delete
CASH IN
Request a cash in token
post
Init Transaction
post
Transaction Status
get
Update a cash in transaction
patch
Delete a cash in transaction
delete
Cash Out
Request a cash out token
post
Init Transaction
post
Transaction Status
get
Update a cash out transaction
patch
Delete a cash out transaction
delete
Card Async
Request a card async token
post
Init Transaction
post
Get Status
get
Async Card Subscriptions
Request a token
post
Init an async card subscription
post
SmartLinks v2
Create a Smartlink
post
Get a Smartlink
get
Delete a smartlink
delete
Update a Smartlink
patch
Analytics
Get transactions list
get
Gateway Status
Get gateway status
get
Commissions
Get Commission Configuration
post
Models
Amount
BadRequestResponse
Billing Address
ChargesVoidCardResponse
ContactDetails
Currency
ErrorResponse
GetConfigurationRequest
InvalidBinResponse
Language
Metadata
Promotions
Shipping Address
Subscription
SubscriptionAdjustmentRequest
SubscriptionUpdate
UnexpectedErrorResponse
extraTaxes
Powered by Stoplight
post

/card/v1/charges

Make a charge with a token provided by Kushki which represents the customer’s credit card.

If you perform a deferred charge with credentials of an Ecuadorian, Mexican or Peruvian merchant, you have to set the deferred object that has the creditType, graceMonths and months.

Remember that for deferred you have to use only one option: months or deferred.

Here is a quick list of types of credit that you can use in the creditType field:

  • “01” = Fixed installments with interest.
  • “02” = Months of grace with interest.
  • “03” = Monthly payment by month with interest.
  • “04” = Fixed installments withouth interest.
  • “05” = Months of grace withouth interest.
  • “06” = Monthly payment by month withouth interest.
  • “07” = Special without interest.
  • “50” = Supermaxi promo.

The exact credytType you have to use for deferred transactions depends on the credit card bin. You can request the deferred options for a specific bin from your frontend with our API or with one of our frontend libraries.

Request Parameters

2 Headers

Request Body

4 Examples
Schema
object
token
string
1 validation + required
amount
object
required
months
integer

For deferred transactions in Chile, Colombia, Mexico and Peru

1 validation
deferred
object

For deferred transactions in Ecuador

metadata
object
fullResponse
boolean
ignoreWarnings
boolean

Set this parameter to true if you want to continue with the charge despite de warning rules

contactDetails
object
required
orderDetails
object
required
productDetails
object

Required when selling products

required

Responses

201400500
1 Example
Schema
object
ticketNumber
string
transactionReference
string
details
object

Only when fullResponse is true

Send a Test Request

SettingsHeaders [2]BodyCode Generation
Send requests directly from the browser (CORS must be enabled)
$$.env
No $$.env variables are being used in this request.