CARD

Request a card token

Make a charge or deferred charge

Void a transaction

Refund a transaction

Request deferred options

Pre-authorize payments

Capture a pre-authorized payment

Card Subscriptions

Request a subscription token

Update a subscription card data

Make a charge on a subscription

Cancel a subscription

Update a subscription

Add a temporary charge or discount

Create a subscription

Pre-authorize payments

Capture a pre-authorized payment

Get Subscription Info

Transfer In

Request a Transfer In token

Init Transaction

Transfer In (MEXICO)

Request a Transfer In token

Init Transaction

Cancel a transfer subscription (CLABE)

Push a transfer payment (sandbox)

Preauthorize an expected transfer

Transfer Out

Request a Transfer Out token

Init Transaction

Void a transaction

CASH IN

Request a cash in token

Init Transaction

Transaction Status

Update a cash in transaction

Delete a cash in transaction

Cash Out

Request a cash out token

Init Transaction

Transaction Status

Update a cash out transaction

Delete a cash out transaction

Card Async

Request a card async token

Init Transaction

Async Card Subscriptions

Request a token

Init an async card subscription

SmartLinks v2

Create a Smartlink

Get a Smartlink

Delete a smartlink

Update a Smartlink

Analytics

Get transactions list

Gateway Status

Get gateway status

Commissions

Get Commission Configuration

Models

BadRequestResponse

Billing Address

ChargesVoidCardResponse

GetConfigurationRequest

InvalidBinResponse

Shipping Address

SubscriptionAdjustmentRequest

SubscriptionUpdate

UnexpectedErrorResponse

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

1 Example

Schema

object

ticketNumber

string

transactionReference

string

details

object

Only when fullResponse is true

Send a Test Request

Send requests directly from the browser (CORS must be enabled)

$$.env

No $$.env variables are being used in this request.