Cash Payments

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

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.
CustomerEmail string Yes Customer’s email.
CustomerFirstName string No Customer’s first name.
CustomerLastName string No Customer’s last name.
CustomerDocumentType string No Customer’s document type.
Refer to the Document types table to see the possible values.
CustomerDocumentNumber string No Customer’s Document Number.
CustomerPhoneNumber string No Customer’s phone number.
CustomerAddressCountry string No Customer’s Country.
CustomerAddressState string No Customer’s State.
CustomerAddressCity string No Customer’s City.
CustomerAddressAddressDetail string No Customer’s Address Detail.
CustomerAddressPostalCode string No Customer’s Postal Code.
RedirectionUrl_Approved string No Callback URL when the purchase status is Approved.
RedirectionUrl_Rejected string No Callback URL when the purchase status is Rejected.
RedirectionUrl_Canceled string No Callback URL when the purchase status is Canceled.
RedirectionUrl_Pending string No Callback URL when the purchase status is Pending.
RedirectionUrl_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
    }
}
footer
Last modified January 10, 2025

© Bamboo | All rights reserved 2025