Implementing is simple

Implementation Guide

digital implementation illustrations

Implementing Khipu

Implementing Khipu in your business is a 100% self-managed process. Despite this, we know that always doubts may arise, both in the integration of the REST API as well as in the charging account(s) configuration.

Although our Help section (lower right corner button) can clarify most of your doubts, in the next lines we will explain the main steps to start receiving payments with Khipu.

In general, the process can be split into four main parts:

  • REST API integration for the payment and charging process.
  • Configuration of the charging account and other details.
  • Graphic materials.
  • Integration of the business’ account system rendering via webservices (optional but recommended).

Integrating the REST API

The complete documentation can be found here, where you will find:

  • Creation process introduction, payment, and validation.
  • Relevant concepts to fully understand the document.
  • Use of the API REST to create charges and receive payments.
  • REST API more advanced uses.
  • How to create the testing environment and final release.
  • How to install libraries in the programming language you need (available languages: PHP, Ruby, Java, .NET).
  • API Reference.
  • How to sign requirements to the API.
  • Mobile apps integration (Android and iOS).

Given our experience, an integration in general takes between two weeks and one month, depending on the amount of time dedicated to the task and your previous experience with Khipu’s or similar APIs.

Charging account creation in Developer mode

Khipu doesn’t have a testing environment separated from production. It uses the main API and platform services. A “developer charging account” is used for development testing. The necessary steps for creating a developer account can be found here.

When you’re done with the integration in developer mode, you will only need to create a production charging account and make the necessary changes (charging account ID and secret key) at the endpoint that you have created during the process. The platform will then be ready.

Charging Account Configuration in the production environment and other details:

To receive payments with Khipu, the first thing you need to do is create a charging account. There are two waysto create a charging account. The first one is without having previously created a user account, the second one is with the user account already created.

Option 1: Without a user account:

The first you need to do is create your user account here .

Next, to create a charging account, enter your recently created account on to the “I pay” section and click on “Create New Charging Account”, you must select Country, and in Type of Account: Commercial Use.

Now you will begin a four steps process:

  • Account creation.
  • Bank selection (where your collected money will be received after rendered by Khipu).
  • Bank account validation (you will need to make a payment for the minimum amount allowed by your bank which will be returned the next business day).
  • Sign the contract: Accept Mandate conditions so Khipu can receive the money on behalf of the business and render it the next business day.

With this you will have created your user account and your first charging account, which you will be able to associate, with its credentials, to the endpoint you will have created in the Khipu development and integration stage.

Option 2: You already have a user account:

Depending on your business, you may need more than a charging account. Either because you want to receive money from different product lines, in different bank accounts, or because you want to have different rate plans.

If that is the case, once you’re in the platform, you will be able to create a new charging account. In the section “I charge”, select “Charge as a New Charging Account” and you will start the same four-stage process described in the first option. In case you enter an account that has been already verified by our system, you will not go through the transfer process to validate your account.

digital implementation illustrations

Other configurations

In your user account it will be important that you enter the company logo. This can be done in the Configuration / User Profile. Ideal image dimensions are 120 x 120 pixels.

You will be able to create one or several charging accounts. For each one, it is important to have a well-established configuration. These configurations can be made in the “Charging Account Options” section of the corresponding “I Charge” account.

Here are some concepts that will be useful to configure the charging account(s):

  • Bank Account to receive payments: You can create several bank accounts and use them one at a time. To create them you will need to make a payment through the platform (for the minimum amount allowed by your bank) which will be returned in the next business day. To this account Khipu will render the money. As in the account validation process, the renditions will be done the next business day.
  • Billing and contact data: To receive an invoice for the Khipu commission instead of a ticket, it is important that you configure this section by filling in your billing, contact and business information.
  • Charges Plan: Here you will be able to visualize the plan associated with the charging account. You can change it whenever you want from here.
  • Users of this Charging Account: You will be able to configure users with profiles with different access levels (Administrator, Commercial, Salesman). A profile is selected, and the user email address is indicated. It is important that the user has already created his user account in Khipu.
  • Notifications by email: There are several important events during the process (payment notifications, proof of payments, daily summary of payments received, monthly summary of payments received, contingency information). Here you will enter the email addresses that will receive these notifications.
  • Payment receipt: Allows for settings such as,if you want the payer to receive the receipt or not, or if you wish the collector email to appear in the receipt. By default, the receipt will be emailed to the payer.

To integrate Khipu to your web site: (In this section you will find valuable information for the API integration)

  • Collector ID and key: Must be entered in the merchant endpoint.
  • Instant Payment Notifications: Where the URL of the web site is entered to receive notifications.
  • URL to receive the daily rendering report: To receive the rendering data through web services and thus, automatically update the accounting and administrative information in the business ERP.
  • URL to receive daily transaction reports: To receive the report through web services.

Integration of rendering reports to the business accounting system (optional but recommended)

An important part of the digital transformation implies that the processes from start to finish are as automatic as possible, allowing swiftness, cost reductions and human errors reduction resulting from manual activities.

In the case of Khipu, from our origins we have made possible to send automatic notifications with the detail of each rendition made to the bank account associated with the charging account.

Although optional, rendering reports integration to the business accounting system is an important part of our value proposition.

Everyday more and more businesses are conducting this type of development due to the automation of their accounting and administrative processes.

Information regarding the rendition integrations to the account system can be found here, in the API documentation.


Graphic Material

We want the integration of Khipu in your business to be a success. And since we know that making a good impression is important, we’ve taken care to provide you with our logo and isotype for different uses in a simple way. Also, we want that the Khipu Payment button to appear in the checkout page of your site, so we’re giving you different types of payment buttons so you can choose the one you like the most.

  • Payment buttons can be found here.

  • Logo and Isotype can be found here.

Chile Address: Las Urbinas 53 oficina 132, Providencia, Santiago, Chile. Postal code 7510093

Argentina Address: Besares 1029, Chacras de Coria, Mendoza, Argentina. Postal code 5505.