Khipu
Khipu allows its users to pay and receive payments via a streamlined bank transfer. Users can choose the Khipu logo during checkout, sign into their online banking, and then enter a two-factor authentication code with their PIN to complete a transaction.
The Paysafe Payments API supports Khipu via SafetyPay as a Payment Instrument for iGaming and Crypto Merchants in Chile. You can process Khipu online payments using the Payments API.
Advantages:
- Instant payment confirmation
- Khipu has no chargebacks risks
- One-step online payments
- Collection notification in real time 24 hours a day
- 100% of bank share in Chile
The Payments API caters to the following needs for Khipu:
- CurrencyCode: CLP
- PaymentType: KHIPU
Setup Requirements
For Paysafe to create a test account in sandbox and production environments, the following information is required.
-
Paysafecard API key
Transaction Types
-
Payments
| AMOUNT IN CHILEAN PESO | |
|---|---|
| Minimum Amount | Maximum Amount |
| $465 | $890,000 |
Note: The amount limits may vary in accordance with the currency exchange rate.
Payments Flow Diagram
Typical Scenarios
Khipu Payment
When you want to process a payment request using Khipu as the payment type, you would do the following:
-
Create a Payment Handle with the transactionType parameter set to PAYMENT and the paymentType parameter set to one of the following value: KHIPU
-
Redirect the customer to the SafetyPay redirect URL so they can generate a payment code. The status of the Payment Handle becomes PAYABLE. The merchant gets notified of this status change via webhooks that have been configured.
-
Use the paymentHandleToken returned in the response to process the Payment request. The Payment will have a status of PROCESSING until the customer has made the payment.
Once the Payment is successfully completed by customer online, the merchant gets Payment Completed notification via webhooks.
API Contracts
Create a Payment Handle Example
{
"paymentType": "KHIPU",
"khipu": {
"consumerId": "merchantclientid5HzDvoZSodKDJ7X7VQ"
},
"transactionType": "PAYMENT",
"amount": 90000,
"currencyCode": "CLP",
"profile": {
"firstName": "ALBERTA",
"lastName": "BOBBETHCHARLESON",
"email": "accountholder0@example.com",
"phone": "1234567890",
"dateOfBirth": {
"day": 23,
"month": 12,
"year": 1990
}
},
"billingDetails": {
"nickName": "John Dee",
"street": "100",
"street2": "Queen Street",
"city": "Cupertino",
"zip": "14236",
"country": "US",
"state": "NY"
},
"merchantRefNum": "1653044860375",
"merchantDescriptor": {
"dynamicDescriptor": "Test Description",
"phone": "5555345456"
},
"shippingDetails": {
"recipientName": "Vishnu",
"street": "20735 Stevens Creek Blvd",
"street2": "Montessori",
"city": "Cupertino",
"zip": "95014",
"country": "US",
"state": "CA"
},
"dupCheck": false,
"deviceFingerprinting": {
"threatMetrixSessionId": "855d67c9-86dd-4b67-a036-72359bf5631a"
},
"returnLinks": [
{
"rel": "on_completed",
"href": "https://api.dev.paysafe.com/checkout/v2/pages/redirect-success.html",
"method": "GET"
},
{
"rel": "on_failed",
"href": "https://api.dev.paysafe.com/checkout/v2/pages/redirect-error.html",
"method": "GET"
},
{
"rel": "default",
"href": "https://api.dev.paysafe.com/checkout/v2/pages/redirect-success.html",
"method": "GET"
}
]
}
Khipu Redirect URL to Generate a Payment Code Example
{
"id": "be3df4ca-8e6e-41be-b94b-70f59bf4e567",
"paymentType": "KHIPU",
"paymentHandleToken": "PHcNvGcySAGkaVye",
"merchantRefNum": "1653044860375",
"currencyCode": "CLP",
"txnTime": "2022-08-19T08:10:19Z",
"billingDetails": {
"street": "100",
"street2": "Queen Street",
"city": "Cupertino",
"zip": "14236",
"state": "NY",
"country": "US"
},
"customerIp": "10.195.57.168",
"status": "INITIATED",
"links": [
{
"rel": "redirect_payment",
"href": "https://api.qa.paysafe.com/alternatepayments/v1/redirect?accountId=1020462070&paymentHandleId=be3df4ca-8e6e-41be-b94b-70f59bf4e567&token=eyJhbGciOiJIUzI1NiJ9.eyJhY2QiOiIxMDIwNDYyMDcwIiwicHlkIjoiYmUzZGY0Y2EtOGU2ZS00MWJlLWI5NGItNzBmNTliZjRlNTY3IiwiZXhwIjoxNjYwODk4NDIwfQ.cEjFPJi8T3PJVN4SCw28t3njohkY707l2WxZLJNIAY0"
}
],
"liveMode": false,
"simulator": "EXTERNAL",
"usage": "SINGLE_USE",
"action": "REDIRECT",
"executionMode": "ASYNCHRONOUS",
"amount": 90000,
"merchantDescriptor": {
"dynamicDescriptor": "Test Description",
"phone": "5555345456"
},
"timeToLiveSeconds": 599,
"gatewayResponse": {
"processor": "PAYSAFECARD",
"id": "pay_1020014798_zcUfQukB3PjsBRhrJGzH1wa2aL8YHOWI_CLP"
},
"returnLinks": [
{
"rel": "on_failed",
"href": "https://api.dev.paysafe.com/checkout/v2/pages/redirect-error.html"
},
{
"rel": "on_completed",
"href": "https://api.dev.paysafe.com/checkout/v2/pages/redirect-success.html"
},
{
"rel": "default",
"href": "https://api.dev.paysafe.com/checkout/v2/pages/redirect-success.html"
}
],
"transactionType": "PAYMENT",
"gatewayReconciliationId": "pay_1020014798_zcUfQukB3PjsBRhrJGzH1wa2aL8YHOWI_CLP",
"updatedTime": "2022-08-19T08:10:20Z",
"statusTime": "2022-08-19T08:10:20Z",
"shippingDetails": {
"recipientName": "Vishnu",
"street": "20735 Stevens Creek Blvd",
"street2": "Montessori",
"city": "Cupertino",
"state": "CA",
"country": "US",
"zip": "95014"
},
"khipu": {
"consumerId": "merchantclientid5HzDvoZSodKDJ7X7VQ"
},
"profile": {
"firstName": "ALBERTA",
"lastName": "BOBBETHCHARLESON",
"email": "accountholder0@example.com",
"dateOfBirth": {
"day": 23,
"month": 12,
"year": 1990
},
"phone": "1234567890"
}
}
Process Payment Request Using paymentHandleToken
{
"merchantRefNum": "1653044860375",
"amount": 90000,
"currencyCode": "CLP",
"dupCheck": true,
"settleWithAuth": true,
"paymentHandleToken": "PHcNvGcySAGkaVye",
"customerIp": "172.0.0.1",
"description": "Casino game purchase"
}
Payment Payment Completed Notification via Webhooks
{
"id": "972fac49-d3f3-43ea-a625-af18bc72a8b1",
"paymentType": "KHIPU",
"paymentHandleToken": "PHcNvGcySAGkaVye",
"merchantRefNum": "1653044860375",
"currencyCode": "CLP",
"settleWithAuth": true,
"dupCheck": false,
"txnTime": "2022-08-19T08:10:19Z",
"billingDetails": {
"street1": "100",
"street2": "Queen Street",
"city": "Cupertino",
"zip": "14236",
"state": "NY",
"country": "US"
},
"status": "PROCESSING",
"gatewayReconciliationId": "pay_1020014798_zcUfQukB3PjsBRhrJGzH1wa2aL8YHOWI_CLP",
"amount": 90000,
"availableToRefund": 0,
"consumerIp": "10.195.57.168",
"liveMode": false,
"simulator": "EXTERNAL",
"updatedTime": "2022-08-19T08:14:20Z",
"statusTime": "2022-08-19T08:14:20Z",
"gatewayResponse": {
"processor": "PAYSAFECARD",
"id": "pay_1020014798_zcUfQukB3PjsBRhrJGzH1wa2aL8YHOWI_CLP"
},
"availableToSettle": 0,
"shippingDetails": {
"recipientName": "Vishnu",
"street": "20735 Stevens Creek Blvd",
"street2": "Montessori",
"city": "Cupertino",
"state": "CA",
"country": "US",
"zip": "95014"
},
"khipu": {
"consumerId": "merchantclientid5HzDvoZSodKDJ7X7VQ"
},
"profile": {
"firstName": "ALBERTA",
"lastName": "BOBBETHCHARLESON",
"email": "accountholder0@example.com",
"dateOfBirth": {
"day": 23,
"month": 12,
"year": 1990
},
"phone": "1234567890"
},
"settlements": {
"amount": 90000,
"txnTime": "2022-08-19T08:10:19.000+0000",
"availableToRefund": 0,
"merchantRefNum": "1653044860375",
"id": "972fac49-d3f3-43ea-a625-af18bc72a8b1",
"status": "RECEIVED"
}
}
To know more about each parameter, you can visit Payments.