Credit and Debit cards

Learn how to integrate your solution to process credit or debit card payments.

Considerations

For VISA Debit: It is not required to be in the Verified by Visa program.
When operating outside a wallet, you must request the Expiration Date and CVV. It serves as a single payment due to being a debit card. It accepts Full Cancellations and Refunds (Total and Partial). It does not allow Two-Step operations (Pre-Authorization).
Purchases without CVV: Allows tokenization and recurrence.
In the case of tokenization, the API generates a charge for a minimum of ARS 3, which is refunded to validate the cardholder data. With this token, it is possible to make purchases without CVV.

Request parameters

Basics

You need to include specific fields for this payment method to work correctly. Check the Purchase operation article for detailed information on authentication, basic purchase parameters, and response languages.

Mandatory and conditional

Property	Type	Mandatory?	Description
`Customer` → `Email`	`string`	Yes	Customer’s email.
`Customer` → `FirstName`	`string`	Yes	Customer’s first name.
`Customer` → `LastName`	`string`	Yes	Customer’s last name.
`Customer` → `DocumentType`	`string`	No	Customer’s document type. Refer to the Document types table to see the possible values.
`Customer` → `Address` → `State`	`string`	No^*	Customer’s State. ^This parameter is required to calculate II.BB** Tax. Refer to provinces to know its possible values*.

Info

Remember that for the Anti-fraud system’s correct functioning, we suggest sending additional data described in the section Anti-fraud.

Request example

{
    "TrxToken": "OT__6dHAgJo6qeg62qIroA7H7_f_NWZZ6IEx4jiYpVJ8SzQ_",
    "UniqueID": "paymentID3022",
    "Capture": true,
    "TargetCountryISO": "AR",
    "Currency": "ARS",
    "Amount": 25000,
    "Installments": 1,
    "Order": "CH2023-001",
    "Description": "Purchase test",
    "Customer": {
        "FirstName": "Joao",
        "LastName": "Silva",
        "ReferenceCode": "JS-001",
        "PhoneNumber": "11987654321",
        "DocumentNumber": "12345678901",
        "DocumentType": "DNI.AR",
        "Email": "joao.silva@example.com",
        "Address": {
            "Country": "AR",
            "City": "Bs As",
            "State": "C",
            "PostalCode": "01310-200",
            "AddressDetail": "Avenida Paulista 1000"
        }
    }
}

Response parameters

For more information on the response parameters, please refer to the Response parameters section of the Purchase creation.

Response example

{
    "TransactionId": "79632697147789184",
    "Result": "COMPLETED",
    "Status": "APPROVED",
    "ErrorCode": null,
    "ErrorDescription": null,
    "Created": "2024-08-07T17:51:54.620",
    "AuthorizationDate": "2024-08-07T17:51:56.879",
    "AuthorizationCode": "839936",
    "Amount": 25000,
    "Currency": "ARG",
    "Installments": 1,
    "TaxableAmount": null,
    "Tip": null,
    "Url": "https://api.stage.bamboopayment.com/Purchase/79632697147789184",
    "MetadataOut": null,
    "Action": null,
    "PaymentMethod": {
        "Brand": "Visa",
        "CardOwner": "Joao Silva",
        "Bin": "450799",
        "IssuerBank": "Santander",
        "Type": "CreditCard",
        "Expiration": "203008",
        "Last4": "4905"
    }
}

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`	`4` - DNI	`38499826`

Last modified December 30, 2024