Accept a Cash Payment

This payment option is ideal for those customers who want to purchase the products or services available on your website, but do not have a card or a bank account. To do so, you need to capture your customer's basic details, to generate a reference or voucher, with which your user will be able to make the payment at an authorized location of the collection entity of their choice.

The payment flow that you will integrate is as shown below:

1. Set up your Front-end#

The front-end is responsible for collecting the user’s main details, generating a token for such information through Kushki’s servers, and sending that information to the back end to start the payment process.

For this, you have two options: Kajita and Kushki.js.

Kajita#

Kushki has payment forms ready to collect card information securely. You can use any of our versions:

Create and customize your Kajitas#

With Kushki you can create your Kajitas from the Administration Console. Click here to learn how to do this.

Set up Kajita#

Include the kushki-checkout.js script in your payment page by adding it to the <head> of your HTML file. Always load kushki-checkout directly from cdn.kushkipagos.com. Do not include the script in a bundle or package or host a copy of it.

Add Kajita to your Website#

Kajita needs a space within your page. Enter the following code in your website's <body>, where you want the payment form to be displayed.

Remember to configure the action of the action form according to the corresponding endpoint in your back end, to obtain the token.

Then, add the following script tag. Make sure that the form has been uploaded.

This will create a predesigned form on your website to accept payments.

Kushki.js#

Use Kushki.js if you need more control over the "look & feel" or appearance of your payment form.

Set up Kushki.js#

Option 1 - CDN#

Use the following script tag at the end of the <body> of your payment page.

Option 2 - NPM#

Install the package from npm.

Then import it into your code using the following code.

Set up Kushki object#

Add the following code to your application

Collect User Information and Send it to your Back End#

First, embed the form in your payment page adding the required fields. You can design it as you prefer.

For example:

And, for the moment the user submits the form, add the token request and take it to your back end.

2. Set up your Back-end#

The back-end is responsible for receiving the token obtained from your front end and starting the payment process with Kushki.

When the user submits the form, your front end sends a token to an endpoint that you specified previously. Using this token, you must make a call to our charges endpoint to start the charge.

According to the consumption response of the method to initiate the transaction, redirect the user to the URL of the PDF of the voucher so that your customer can download and print it and thus make the payment at the authorized location point of the collection entity of their choice.

3. Test your Integration#

There are test identification numbers that you can use to simulate status to ensure that your integration is ready. Use them in the token request (front end):

4. Prepare your Certification#

Read the following guidelines for technical certification approval (required to obtain productive account credentials):

If you are using Kushki.js, make sure that:

If you design your own voucher, also consider the following:

---