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.
| Property | Type | Description |
|---|---|---|
Customer → Email | string | Customer’s email. |
Customer → FirstName | string | Customer’s first name. |
Customer → LastName | string | Customer’s last name. |
Conditionally required / recommended
| Property | Type | Guidance |
|---|---|---|
Customer → DocumentType | string | Optional. Use when an identification document is required (e.g., DNI, CUIT, CUIL). See the document types table. |
Customer → Address → State | string | Optional, but required to calculate IIBB (use a valid province code). |
CardData → CVV / CardData → Expiration | string | For 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
Review Create Purchase Guide
Check the global request and response rules before building your request.
Try it in API Reference
Test the endpoint directly and explore real request/response examples.
Testing cards
Use the following cards to simulate the different status of the purchase.
For approved purchases
| Brand | PAN | CVV | Expiration Date | Details |
|---|---|---|---|---|
| Mastercard | 5299910010000015 | 123 | 08/30 | No amount limit |
| Visa (credit or debit) | 4507990000004905 | 123 | 08/30 | No amount limit |
| Amex | 373953192351004 | 1234 | 08/30 | Amounts: $1 or $10 |
For rejected purchases
| PAN | CVV | Expiration Date | Document Type | Document |
|---|---|---|---|---|
4304968001555104 | 617 | 12/18 | DNI.AR | 38499826 |
Discover the API
Once you’re familiar with how to create a purchase, you can test your integration using our API Reference
Updated 15 days ago
