Credit and Debit cards

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

You can create the purchase using API or Redirection flow.

Considerations

Debit cards using the API flow is available for full capture (Purchase operation).
The CVV is mandatory for debit cards.
The maximum time to confirm a transaction is seven calendar days.
Chile does not support decimal amounts, so all received amount values will be rounded.

Card payments using API flow

Using this flow, you can offer the possibility to receive payments using cards without the intervention of the payer.

Request parameters

You need to include specific fields for this payment method to work correctly. Check the Purchase operation article for details on authentication, languages of the response, and basic purchase parameters such as amount and currency.

Property	Type	Mandatory?	Description
`TrxToken`	`string`	Yes	The token that identifies the customer’s card. For more information about how to create the token, refer to Customers.
`TargetCountryISO`	`string`	Yes	Indicate the destination country.
`Customer` → `Email`	`string`	Yes	Customer’s email.
`Customer` → `FirstName`	`string`	No	Customer’s first name.
`Customer` → `LastName`	`string`	No	Customer’s last name.
`Customer` → `DocumentType`	`string`	No	Customer’s document type. Refer to the Document types table to see the possible values.
`Customer` → `DocumentNumber`	`string`	No	Customer’s Document Number.
`Customer` → `PhoneNumber`	`string`	No	Customer’s phone number.
`Customer` → `Address` → `Country`	`string`	No	Customer’s Country.
`Customer` → `Address` → `State`	`string`	No	Customer’s State.
`Customer` → `Address` → `City`	`string`	No	Customer’s City.
`Customer` → `Address` → `AddressDetail`	`string`	No	Customer’s Address Detail.
`Customer` → `Address` → `PostalCode`	`string`	No	Customer’s Postal Code.

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": "CL",
    "Currency": "CLP",
    "Amount": 25000,
    "Installments": 1,
    "Order": "CH2023-001",
    "Description": "Purchase Test",
    "Customer": {
        "FirstName": "Joao",
        "LastName": "Silva",
        "ReferenceCode": "JS-001",
        "PhoneNumber": "11987654321",
        "DocumentNumber": "12345678901",
        "DocumentType": "RUT.CL",
        "Email": "joao.silva@example.com",
        "Address": {
            "Country": "CL",
            "City": "Santiago de Chile",
            "State": "SP",
            "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": "CLP",
    "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. These cards apply for both API and redirection flow.

For approved purchases

Brand	PAN	CVV	Expiration Date	Type
Amex	`370000000002032`	`1234`	`10/29`	Credit
Visa	`4051885600446623`	`123`	`10/29`	Credit
Visa	`4051886000056590`	`123`	`10/29`	Prepaid

Info note

If the RUT and password are requested, please use a valid RUT (for example 11.111.111-1) and password 123.

For rejected purchases

Brand	PAN	CVV	Expiration Date	Type
MasterCard	`5186059559590568`	`123`	`10/29`	Credit
MasterCard	`5186174110629480`	`123`	`10/29`	Prepaid

Last modified December 20, 2024