# Installments
{% hint style="success" %}
Please check-in with your Sales contact for the corresponding configuration and eligibility of this functionality.
{% endhint %}
Server2Server
To create a deposit with installments through our Server2Server solution, the parameter **`installments`** should be sent in the request with a valid amount of installments.
The deposit will be synchronously processed, and charged with installments to the cardholder with the amount detailed in the **`installments`** parameter.
curl -L \
--request POST \
--url 'https://cc-api-stg.onekeypayments.com/v3/deposits' \
--header 'Content-Type: application/json' \
--header 'X-Date: 2025-07-15T12:57:14.936Z' \
--header 'X-Login: text' \
--header 'Authorization: text' \
--data '{
"invoice_id": "800000001",
"amount": 1000,
"country": "BR",
"currency": "BRL",
"installments":3,
"payer": {
"id": "11111",
"document": "84932568207",
"document_type": "CPF",
"email": "johnSmith12@hotmail.com",
"first_name": "John",
"last_name": "Smith",
},
"credit_card": {
"cvv": "123",
"card_number": "4111111111111111",
"expiration_month": "10",
"expiration_year": "25",
"holder_name": "JOHN SMITH"
}
}'
Fragments Lite
Fragments Lite is similar to our Server2Server solution in regards of charging deposits with Installments.\
Remember, that in this solution you should send the **`card_token`** instead of the `credit_card[]` object alongside with **`installments`** parameter.
curl -L \
--request POST \
--url 'https://cc-api-stg.onekeypayments.com/v3/deposits' \
--header 'Content-Type: application/json' \
--header 'X-Date: 2025-07-15T12:57:14.936Z' \
--header 'X-Login: text' \
--header 'Authorization: text' \
--data '{
"invoice_id": "800000001",
"amount": 1000,
"country": "BR",
"currency": "BRL",
"installments":3,
"payer": {
"id": "11111",
"document": "84932568207",
"document_type": "CPF",
"email": "johnSmith12@hotmail.com",
"first_name": "John",
"last_name": "Smith",
},
"card_token": "C4RD_T0K3N_G3N3R4T3D_W1TH_FR4GM3N7S_L1T3"
}'
Fragments all-in-one
Merchants using the Fragments all-in-one solution can offer payments in installments to their users.
For doing so, they must include in the deposit request the parameter **`allow_installments`** with value **`true`**. The frontend component will render the dropdown for the user to select the desired amount.
curl -L \
--request POST \
--url 'https://api-stg.onekeypayments.com/v3/deposits' \
--header 'Content-Type: application/json' \
--header 'X-Date: 2025-07-17T13:13:15.442Z' \
--header 'X-Login: text' \
--header 'Authorization: text' \
--data '{
"invoice_id" : "1000000001",
"amount": "1000",
"country": "MX",
"currency": "MXN",
"payer": {
"id": "11",
"document": "CURP4321TEST",
"first_name": "Ricardo",
"last_name": "Carlos",
"email": "juanCarlos@hotmail.com"
},
"payment_method": "CC",
"token_requested":true,
"allow_installments":true,
"client_ip": "123.123.123.123",
"back_url": "https://www.merchant.com/deposit_cancelled",
"success_url": "https://www.merchant.com/deposit_completed",
"error_url": "https://www.merchant.com/deposit_error",
"notification_url": "https://www.merchant.com/onekeypayments/notify"
}'
OneShot
In the OneShot integration, users select the desired amount of installments in the credit card checkout page.
In order to display the installments dropdown to the user, merchants must indicate in the deposit request that installments are allowed, with the parameter **`allow_installments`** with value **`true`**
curl -L \
--request POST \
--url 'https://api-stg.onekeypayments.com/v3/deposits' \
--header 'Content-Type: application/json' \
--header 'X-Date: 2025-07-17T13:13:15.442Z' \
--header 'X-Login: text' \
--header 'Authorization: text' \
--data '{
"invoice_id" : "1000000001",
"amount": "1000",
"country": "MX",
"currency": "MXN",
"payer": {
"id": "11",
"document": "CURP4321TEST",
"first_name": "Ricardo",
"last_name": "Carlos",
"email": "juanCarlos@hotmail.com"
},
"payment_method": "CC",
"allow_installments": true,
"client_ip": "123.123.123.123",
"back_url": "https://www.merchant.com/deposit_cancelled",
"success_url": "https://www.merchant.com/deposit_completed",
"error_url": "https://www.merchant.com/deposit_error",
"notification_url": "https://www.merchant.com/onekeypayments/notify"
"logo": "https://www.merchant.com/merchant-logo.png",
}'
#### Experience
| Regular card | Multiplo card |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  |  |