Credit and Debit Cards

Process card payments in Argentina using Bamboo’s API. Review required parameters, examples in ARS, and card-specific rules for Visa Debit and tokenized payments.

This page describes Argentina-specific requirements for the Create a Purchase operation. Refer to the Create a Purchase guide for the full parameter list and base definitions.


🔁

This payment methods use an API flow. The response to the purchase request will include the final status (COMPLETED, REJECTED, etc.), without redirection.


Mandatory fields for Argentina

The following fields are required in addition to the global mandatory parameters.

PropertyTypeDescription
CustomerEmailstringCustomer’s email.
CustomerFirstNamestringCustomer’s first name.
CustomerLastNamestringCustomer’s last name.

Conditionally required / recommended

PropertyTypeGuidance
CustomerDocumentTypestringOptional. Use when an identification document is required (e.g., DNI, CUIT, CUIL). See the document types table.
CustomerAddressStatestringOptional, but required to calculate IIBB (use a valid province code).
CardDataCVV / CardDataExpirationstringFor Visa Debit outside a wallet, Expiration and CVV are required. Two-step (pre-authorization) is not supported.

Considerations

Visa Debit Verified by Visa enrollment is not required. When operating outside a wallet, include Expiration Date and CVV in the request. Transactions are processed as single-step payments (no pre-authorization). Supports full and partial refunds only.

Tokenized Cards (without CVV) Tokenized cards can be used for recurring payments without CVV. During tokenization, the API performs a temporary ARS 3 charge (automatically refunded) to validate the cardholder. Once validated, the token can be reused for future purchases without CVV.


⚠️

Transactions missing these parameters will be rejected by acquirers in Argentina.



Request example using Token

To test this endpoint, use the API Reference or the Postman Collection

{
  "TrxToken": "OT__ar_7Jr8K2rQyZC9m4fVx1pQw2e3s4t5u6v",
  "UniqueID": "ar-order-10001",
  "Capture": true,
  "TargetCountryISO": "AR",
  "Currency": "ARS",
  "Amount": 25000,
  "Installments": 1,
  "Order": "AR-INV-10001",
  "Description": "Compra online - Pedido 10001",
  "Customer": {
    "FirstName": "María",
    "LastName": "González",
    "ReferenceCode": "CLI-AR-0001",
    "PhoneNumber": "1145678900",
    "DocumentNumber": "30123456",
    "DocumentType": "DNI.AR",
    "Email": "[email protected]",
    "Address": {
      "Country": "AR",
      "City": "Buenos Aires",
      "State": "C",
      "PostalCode": "C1001AAA",
      "AddressDetail": "Av. Corrientes 1234, Piso 5, Depto B"
    }
  },
  "CustomerIP": "190.10.224.231",
  "AntifraudData": {
    "AntifraudFingerprintId": "0046f17b-197a-4d63-8b6b-6082cdd557ff"
  }
}

Request example using Card Data

To test this endpoint, use the API Reference or the Postman Collection

{
    "CardData": {
        "CardHolderName": "María Gonzalez",
        "Pan": "4507990000004905",
        "CVV": "123",
        "Expiration": "08/30",
        "Email": "[email protected]",
        "Document": "30123456"
    },
  "UniqueID": "ar-order-10001",
  "Capture": true,
  "TargetCountryISO": "AR",
  "Currency": "ARS",
  "Amount": 25000,
  "Installments": 1,
  "Order": "AR-INV-10001",
  "Description": "Compra online - Pedido 10001",
  "Customer": {
    "FirstName": "María",
    "LastName": "González",
    "ReferenceCode": "CLI-AR-0001",
    "PhoneNumber": "1145678900",
    "DocumentNumber": "30123456",
    "DocumentType": "DNI.AR",
    "Email": "[email protected]",
    "Address": {
      "Country": "AR",
      "City": "Buenos Aires",
      "State": "C",
      "PostalCode": "C1001AAA",
      "AddressDetail": "Av. Corrientes 1234, Piso 5, Depto B"
    }
  },
  "CustomerIP": "190.10.224.231",
  "AntifraudData": {
    "AntifraudFingerprintId": "0046f17b-197a-4d63-8b6b-6082cdd557ff"
  }
}

Response parameters



Testing cards

Use the following cards to simulate the different status of the purchase.

For approved purchases

BrandPANCVVExpiration DateDetails
Mastercard529991001000001512308/30No amount limit
Visa (credit or debit)450799000000490512308/30No amount limit
Amex373953192351004123408/30Amounts: $1 or $10

For rejected purchases

PANCVVExpiration DateDocument TypeDocument
430496800155510461712/18DNI.AR38499826


Discover the API

Once you’re familiar with how to create a purchase, you can test your integration using our API Reference