Bank Transfers

Learn how to integrate your solution to process payments with Bank transfers.

Info

The purchase status for Alternative Payment methods will remain Pending until the customer completes payment either in their Khipu.
Chile does not support decimal amounts, so all received amount values will be rounded.

Khipu

Khipu allows payers to pay using transfers from their bank accounts using the Khipu app. The payer can pay using bank accounts or through the Khipu app where the payment experience is better.

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
`PaymentMethod`	`string`	Yes	Find the value in the table Payment Method.
`TargetCountryISO`	`string`	Yes	Indicate the destination country.
`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` → `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.
`Redirection` → `Url_Approved`	`string`	No	Callback URL when the purchase status is `Approved`.
`Redirection` → `Url_Rejected`	`string`	No	Callback URL when the purchase status is `Rejected`.
`Redirection` → `Url_Canceled`	`string`	No	Callback URL when the purchase status is `Canceled`.
`Redirection` → `Url_Pending`	`string`	No	Callback URL when the purchase status is `Pending`.
`Redirection` → `Url_Notify`	`string`	No	Webhook notification URL. The Purchase status is notified to this URL once the payment method processor notifies Bamboo. The notification to this URL is a REST POST with JSON payload instead of redirection. It can also be static and configured by Support Team.
`MetaDataIn` → `PaymentExpirationInMinutes`	`numeric`	No	Configure the expiration time for the payment using this field, specifying the duration in minutes. The API applies a default value if you don’t provide this information.

Info

The Redirection object and its parameter are not required; nevertheless, you must configure it to redirect your customer after the transaction finishes in any status.

Request example

{
    "PaymentMethod": "KHI",
    "Amount": 100000,
    "Currency": "CLP",
    "TargetCountryISO": "CL",
    "Customer": {
        "Email": "john@mail.com",
        "FirstName": "John"
    },
    "Redirection": {
        "Url_Approved": "https://dummystore.com/checkout/approved",
        "Url_Rejected": "https://dummystore.com/checkout/rejected",
        "Url_Canceled": "https://dummystore.com/checkout/canceled",
        "Url_Pending": "https://dummystore.com/checkout/pending",
        "Url_Notify": "https://webhook.site/9e2dff8b-cec6-4540-bd2d-feafce58a9ed"
    },
    "Description": "this is a test cash purchase"
}

Response parameters

We return the Purchase with the status Pending for Redirection and a Action object with Reason as REDIRECTION_NEEDED_EXTERNAL_SERVICE and the URL parameter with the external service URL. You must redirect the customer to this URL to finish the payment on the Khipu app.

Info

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

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

Response example

{
    "TransactionId": "79632697147789184",
    "Result": "ACTION_REQUIRED",
    "Status": "PENDING",
    "ErrorCode": null,
    "ErrorDescription": null,
    "Created": "2024-08-07T17:51:54.620",
    "AuthorizationDate": null,
    "AuthorizationCode": null,
    "Amount": 100000,
    "Currency": "CLP",
    "Installments": 1,
    "TaxableAmount": null,
    "Tip": null,
    "Url": "https://api.stage.bamboopayment.com/Purchase/79632697147789184",
    "MetadataOut": null,
    "Action": {
        "SessionId": "CA_f1696826-3607-47ef-adba-94291876758b",
        "URL": "https://redirect.stage.bamboopayment.com/CA_f1696826-3607-47ef-adba-94291876758b",
        "Reason": "REDIRECTION_NEEDED_EXTERNAL_SERVICE"
    },
     "PaymentMethod": {
        "Brand": "Khipu",
        "CardOwner": null,
        "Bin": null,
        "IssuerBank": null,
        "Type": "BankTransfer",
        "Expiration": null,
        "Last4": null
    }
}

Last modified January 20, 2025