2. Make a charge or deferred charge

POST

/card/v1/charges

Request

Header Params

Body Params application/json

Examples

Responses

🟢201

application/json

Body

🟠400

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/card/v1/charges' \
--header 'Private-Merchant-Id: {{EC-Private-Merchant-Id}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "token": "{{token}}",
  "amount": {
    "subtotalIva": 0,
    "subtotalIva0": 10,
    "ice": 0,
    "iva": 0,
    "currency": "USD",
    "extraTaxes": {
        "iac": 0,
        "tasaAeroportuaria": 0,
        "agenciaDeViaje": 0
    }
  },
  "deferred": {
    "graceMonths": "02",
    "creditType": "01",
    "months": 3
  },
  "metadata": {
    "contractID": "157AB"
  },
  "contactDetails": {
    "documentType": "RUC",
    "documentNumber": "1234567890",
    "email": "user@example.com",
    "firstName": "John",
    "lastName": "Doe",
    "phoneNumber": "+593912345678"
  },
  "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": 5,
        "sku": "10101042",
        "quantity": 1
      },
      {
        "id": "198953AB",
        "title": "eBook Virtual Selling",
        "price": 5,
        "sku": "004834GQ",
        "quantity": 1
      }
    ]
  },
  "fullResponse": "v2"
}'

Response Example

201 - 201 - Deferred Charge - Successful request

{
    "ticketNumber": "922952698245584720",
    "details": {
        "token": "b6cc761ddbdc4549897d8b1061a028f9",
        "deferred": {
            "graceMonths": "02",
            "creditType": "01",
            "months": 3
        },
        "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": 5,
                    "sku": "10101042",
                    "quantity": 1
                },
                {
                    "id": "198953AB",
                    "title": "eBook Virtual Selling",
                    "price": 5,
                    "sku": "004834GQ",
                    "quantity": 1
                }
            ]
        },
        "fullResponse": true,
        "ip": "187.252.250.61",
        "maskedCardNumber": "545195XXXXXX5480",
        "currencyCode": "USD",
        "recap": "874859",
        "approvedTransactionAmount": 10,
        "acquirerBank": "Banco Internacional",
        "subtotalIva": 0,
        "subtotalIva0": 10,
        "created": 1657578842000,
        "responseCode": "000",
        "transactionType": "SALE",
        "approvalCode": "000000",
        "transactionStatus": "APPROVAL",
        "syncMode": "online",
        "merchantId": "20000000108850614000",
        "processorType": "gateway",
        "transactionId": "440262831257204912",
        "metadata": {
            "contractID": "157AB"
        },
        "responseText": "Transacción aprobada",
        "cardHolderName": "Jhon Doe",
        "lastFourDigits": "5480",
        "binCard": "545195",
        "paymentBrand": "Master Card",
        "cardType": "credit",
        "numberOfMonths": 3,
        "iceValue": 0,
        "requestAmount": 10,
        "ivaValue": 0,
        "merchantName": "Tu comercio",
        "processorName": "Credimatic Processor",
        "graceMonths": "02",
        "creditType": "01",
        "processorBankName": "0032~BANCO INTERNACIONAL",
        "transactionReference": "1617cf61-978c-4a74-8767-7a3ff4daf1a5",
        "issuingBank": "BANCO DE LA PRODUCCION S.A. (PRODUBANCO)",
        "contactDetails": {
            "documentType": "RUC",
            "documentNumber": "1234567890",
            "email": "user@example.com",
            "firstName": "John",
            "lastName": "Doe",
            "phoneNumber": "+593912345678"
        },
        "country": "Ecuador",
        "foreignCard": false,
        "socialReason": "Tu comercio",
        "binInfo": {
            "bank": "BANCO DE LA PRODUCCION S.A. (PRODUBANCO)",
            "type": "credit"
        },
        "cardCountry": "Ecuador",
        "rules": []
    },
    "transactionReference": "1617cf61-978c-4a74-8767-7a3ff4daf1a5"
}

Modified at 2026-01-06 19:33:02

1. Request a card token

3. Void a transaction