Cash Payments

Learn how to integrate your solution to process payments with Cash methods.

Info

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

Klap Efectivo

With Klap efectivo, your customers can generate a coupon and complete the payment in a physical payment office.

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`	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.
`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.

Request 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_c3939722-8c71-437d-a368-3b0349335233",
        "URL": "https://redirect.stage.bamboopayment.com/CA_c3939722-8c71-437d-a368-3b0349335233",
        "Reason": "REDIRECTION_NEEDED_EXTERNAL_SERVICE"
    },
     "PaymentMethod": {
        "Brand": "Multicaja Redirect",
        "CardOwner": null,
        "Bin": null,
        "IssuerBank": null,
        "Type": "PhysicalNetwork",
        "Expiration": null,
        "Last4": null
    }
}

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 let the customer generate the coupon and complete the payment in a Klap office.

PrintScreen

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_c3939722-8c71-437d-a368-3b0349335233",
        "URL": "https://redirect.stage.bamboopayment.com/CA_c3939722-8c71-437d-a368-3b0349335233",
        "Reason": "REDIRECTION_NEEDED_EXTERNAL_SERVICE"
    },
     "PaymentMethod": {
        "Brand": "Multicaja Redirect",
        "CardOwner": null,
        "Bin": null,
        "IssuerBank": null,
        "Type": "PhysicalNetwork",
        "Expiration": null,
        "Last4": null
    }
}

Last modified January 20, 2025