2. Make a charge or deferred charge
POST
/card/v1/charges
Request
Header Params
Body Params application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/card/v1/charges' \
--header 'Private-Merchant-Id: {{PE-Private-Merchant-Id}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"token": "{{token}}",
"amount": {
"subtotalIva": 0,
"subtotalIva0": 50,
"ice": 0,
"iva": 0,
"currency": "PEN",
"extraTaxes": {
"iac": 0,
"tasaAeroportuaria": 0,
"agenciaDeViaje": 0
}
},
"metadata": {
"contractID": "157AB"
},
"contactDetails": {
"documentType": "PAS",
"documentNumber": "1234567890",
"email": "user@example.com",
"firstName": "John",
"lastName": "Doe",
"phoneNumber": "+513912345678"
},
"orderDetails": {
"siteDomain": "example.com",
"shippingDetails": {
"name": "John Doe",
"phone": "+513912345678",
"address": "Av. Simón Bolivar 1515",
"city": "Lima",
"region": "Pueblo Libre",
"country": "Perú",
"zipcode": "15084"
},
"billingDetails": {
"name": "John Doe",
"phone": "+593912345678",
"address": "Av. Simón Bolivar 1515",
"city": "Lima",
"region": "Pueblo Libre",
"country": "Perú",
"zipCode": "15084"
}
},
"productDetails": {
"product": [
{
"id": "198952AB",
"title": "eBook Digital Services",
"price": 30,
"sku": "10101042",
"quantity": 1
},
{
"id": "198953AB",
"title": "eBook Virtual Selling",
"price": 20,
"sku": "004834GQ",
"quantity": 1
}
]
},
"fullResponse": "v2"
}'Response Response Example
201 - 201 - Single Charge fullResponse true- Successful request
{
"ticketNumber": "906474301225304496",
"details": {
"token": "c4c90d3b61f243f18a9977a3abaff322",
"orderDetails": {
"siteDomain": "example.com",
"shippingDetails": {
"name": "John Doe",
"phone": "+593912345678",
"address1": "Eloy Alfaro 139 y Catalina Aldaz",
"address2": "centro 123",
"city": "Quito",
"region": "Pichincha",
"country": "Ecuador",
"zipcode": "170402"
},
"billingDetails": {
"name": "John Doe",
"phone": "+593912345678",
"address1": "Eloy Alfaro 139 y Catalina Aldaz",
"address2": "centro 123",
"city": "Quito",
"region": "Pichincha",
"country": "Ecuador",
"zipCode": "170402"
}
},
"productDetails": {
"product": [
{
"id": "198952AB",
"title": "eBook Digital Services",
"price": 10,
"sku": "10101042",
"quantity": 1
},
{
"id": "198953AB",
"title": "eBook Virtual Selling",
"price": 6.98,
"sku": "004834GQ",
"quantity": 1
}
]
},
"fullResponse": true,
"currencyCode": "USD",
"ip": "187.252.248.209",
"maskedCardNumber": "545195XXXXXX5480",
"approvedTransactionAmount": 2,
"acquirerBank": "",
"subtotalIva": 0,
"subtotalIva0": 2,
"created": 1646879593000,
"responseCode": "000",
"transactionType": "SALE",
"approvalCode": "000000",
"transactionStatus": "APPROVAL",
"syncMode": "online",
"merchantId": "20000000108481570000",
"processorType": "gateway",
"transactionId": "244550982852033116",
"metadata": {
"contractID": "157AB"
},
"responseText": "Transacción aprobada",
"cardHolderName": "John Doe",
"lastFourDigits": "5480",
"binCard": "545195",
"paymentBrand": "Master Card",
"cardType": "credit",
"iceValue": 0,
"requestAmount": 2,
"ivaValue": 0,
"merchantName": "Tu comercio",
"processorName": "MC Processor",
"processorBankName": "0032~BANCO INTERNACIONAL",
"transactionReference": "f3fc0fde-1e95-48d5-8c3d-f18cd73d2c37",
"issuingBank": "BANCO DE LA PRODUCCION S.A. (PRODUBANCO)",
"contactDetails": {
"documentType": "CC",
"documentNumber": "1234567890",
"email": "user@example.com",
"firstName": "John",
"lastName": "Doe",
"phoneNumber": "+593912345678"
},
"country": "Peru",
"foreignCard": true,
"binInfo": {
"bank": "BANCO DE LA PRODUCCION S.A. (PRODUBANCO)",
"type": "credit"
},
"cardCountry": "Ecuador",
"rules": []
},
"transactionReference": "f3fc0fde-1e95-48d5-8c3d-f18cd73d2c37"
}Modified at 2026-01-06 19:33:02