Distribute payments in cash from your platformDistributing cash payments means delivering money physically to your customers or assistants. In other words, imagine that you offer a service or a product and to deliver it, you need the help of a third party, who will charge you for this service. The money paid for the service provided by a third party through this method of payment distribution makes this process easier, because by using a reference, the service provider goes to his/her nearest cash point and withdraws the money.Payments for suppliers or sellers
Due to our risk policies, the available payment methods and the integration type may vary once you complete the affiliation. We will tell you how to proceed if this process applies to your merchant.
1. Tokenize Data#
In this step, it is essential to collect the user's data safely and generate a token for that information. You have to make a call to our tokenization endpoint.Make sure of sending the user's full name and surnames in the name and lastName parameters, as detailed in the following example.
2. Initialize the Transaction#
Now, you need to use the token obtained to start the payment distribution process with Kushki. With this token, you simply must make a call to our initialization endpoint.The response delivers a reference voucher that users can show at the nearest, or their preferred cash point, and withdraw their money.We show you an example below:Additionally, the data you need to generate a voucher using your design is also delivered.Note that generating a voucher using your own design will involve stricter verification by our agents in the certification process.
3. Check the Transaction Status (Optional)#
Now that a voucher has been generated for the user to withdraw his/her money, you can track the transaction status either via Webhooks or manually, by using our API.Webhooks#
The transaction status is automatically notified at the time when the money has been withdrawn.To configure a webhook in your test merchant site, you need to notify our agents by indicating the URL and the payment method via email.
API#
4. Test your Integration#
You may use a test identification document in test mode to ensure that your integration is ready.Approved transaction: 123456789
5. Prepare your Certification#
Read the following guidelines for technical certification approval (required to obtain productive account credentials):Tax calculations must be correct.
Messages displayed on the screen should be aligned with Kushki's responses.
Save and record all the responses delivered by Kushki (required if you need support).
If there's no requirement for sending a reference voucher to the customer's mail, you don't need to specify an email address in the token request.
If webhook notifications are received correctly, respond to the request with a status 200.
The payment button must be disabled after the first click.
Kushki's logo is visible. You may download these resources in this link. Make sure that in the body of the request all the fields required in the API Reference are included. The agreement number must be visible. (only if the Init response contains it).
The voucher expiry date must be visible.
Cash points where the pin can be used to withdraw the money must be visible.
The total amount is visible.
Front End Solutions (Optional)#
Kushki also provides optional tools so that you can use to display a withdrawal form in your front end, optimizing the tokenization process. For example, this is useful when you don't want or don't need to save the transaction data of the users. We offer you two solutions for data tokenization: Cajita and Kushki.js_Cajita#
Use Cajita to simplify your integration and provide a ready-to-use solution to collect user data safely.Set up Cajita#
Embed kushki-checkout.js script in your payment page by adding it to the <head> of your HTML file. Always download kushki-checkout directly from cdn.kushkipagos.com to keep kushki-checkout.js always downloaded directly from cdn.kushkipagos.com. __Never embed a script in a bundle or a package, nor host a copy of it. __Add Cajita to your Website#
Cajita needs a place to live on your page. Enter the following code in your site's <body>, where you want the payment form to be displayed.Remember to configure the action in the action form, according to the corresponding endpoint in your back end.Then, add the following script tag. Make sure that the form has been uploaded.This will create a pre-designed 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 in your code using the following code.Set up Kushki Object.#
Add the following code to your applicationFirst, embed the form in your payment page adding the required fields. You can design it in the way that best suits you.Then, for the moment when the user submits the form, add a token request and send it to your back end.
Manage your payment distributions
Modify or remove your payment distribution transactions.Distribute payments by wire transfers
Distribute payments safely by wire transfers. 
