KHIPU

Khipu permet à ses utilisateurs de payer et de recevoir des paiements par le biais d’un virement bancaire simplifié. Les utilisateurs choisissent le mode de paiement Khipu, se connectent à leur banque en ligne et saisissent un code d’authentification à deux facteurs avec leur code NIP pour effectuer une transaction.

L’API Paiements de Paysafe prend en charge Khipu via SafetyPay en tant qu’instrument de paiement pour les marchands de jeux en ligne et de cryptomonnaies au Chili.

Khipu est un des modes de paiement les plus populaires au Chili. Il est proposé par le biais du mode de paiement par virement en ligne, car de nombreux marchands le considèrent comme faisant partie du virement bancaire. Toutefois, si vous souhaitez proposer un mode de paiement distinct, vous pouvez utiliser l’implémentation mentionnée ici.

Fonctionnalités

Khipu :

Confirmation instantanée du paiement.
Ne comporte aucun risque en matière de rétrofacturation.
Permet d’effectuer des paiements en ligne en une seule étape.
Notification de la collecte en temps réel 24 heures sur 24.
100 % des parts de la banque au Chili

Exigences de configuration

Pour créer un compte dans l’environnement de bac à sable et dans l’environnement de production, vous devez suivre les étapes ci-dessous. Votre gestionnaire de compte vous guidera dans ce processus.

Envoyez vos renseignements à it_integrations@safetypay.com
- Vous recevrez un accès au portail où vous verrez les renseignements suivants
  - Clé secrète du marchand
  - Clé de signature du marchand
Fournissez-nous ces détails pour créer votre clé API; vous utiliserez cette clé API dans vos appels à l’API.

Exigences en matière de certification

Chaque marchand doit passer par un processus de certification pour accepter SafetyPay Express comme mode de paiement. L’équipe d’intégration de Paysafe communiquera les exigences en matière de certification.

Types de transaction

Paysafe prend en charge les types de transactions suivants :

Paiements : pour transférer de l’argent du compte bancaire du client vers le compte du marchand. Après un paiement réussi, le marchand crédite le portefeuille du client.
Montant maximum : 5 000 000 CLP
Devise de traitement : CLP
Devise de règlement : USD

REMARQUE : La CLP n’a pas d’unité monétaire mineure. Cependant, lorsque vous envoyez une requête API, vous devez envoyer le montant avec 2 décimales, afin de maintenir la cohérence entre tous les modes de paiement, car 2 décimales est un format standard dans l’API Paiements de Paysafe. Lorsque vous souhaitez traiter le montant de 123 en CLP par exemple, vous devez envoyer le montant sous la forme 12300 dans votre requête API.

Diagramme de flux des paiements

Scénarios habituels

Pour traiter une requête de paiement en utilisant Khipu comme mode de paiement, procédez comme suit :

Créez un Payment Handle avec les paramètres suivants :
transactionType : PAYMENT
paymentType : KHIPU
- Il est également possible d’afficher des banques particulières à l’utilisateur dans SafetyPay express en envoyant des codes bancaires dans la requête.
- Vous devez transmettre bankNameCodes dans la requête.
- Consultez le tableau au bas de la page pour bankNameCodes.
Redirigez le client vers l’URL de redirection SafetyPay afin qu’il puisse générer un code de paiement. À ce stade, l’état du Payment Handle devient PAYABLE. Le marchand est informé de ce changement d’état par les webhooks qui ont été configurés.
Utilisez le paymentHandleToken renvoyé dans la réponse pour traiter la requête de paiement. Le paiement sera à l’état PROCESSING jusqu’à ce que le client ait effectué le paiement.

Vous recevrez une notification de paiement terminé via les webhooks lorsque le client aura effectué le paiement avec succès.

Liens renvoyés

Une fois que le client a été redirigé vers SafetyPay Express, vous recevrez un webhook de Payment Handle. Lorsque vous effectuez un appel /payments, vous obtiendrez un état de paiement soit en cours de traitement, soit terminé, soit échoué.
Une fois que le client a terminé la transaction sur Safetypay Express, il est redirigé vers votre lien de renvoi. Vous pouvez vérifier l’état de la réponse /payments et rediriger le client vers la page appropriée en fonction de l’état du paiement :

État d’un paiement	Description
PROCESSING	La transaction n’est pas terminée et est en cours. Cela ne signifie pas que la transaction a échoué. Vous recevrez un webhook COMPLETED ou FAILED pour cette transaction à un stade ultérieur quand vous pourrez mettre à jour l’état de la transaction de votre côté.
COMPLETED	Le client a terminé la transaction avec succès du côté de SafetyPay.
FAILED	Le paiement a expiré du côté de SafetyPay.

État d’un paiement

Description

PROCESSING

La transaction n’est pas terminée et est en cours. Cela ne signifie pas que la transaction a échoué.

Vous recevrez un webhook COMPLETED ou FAILED pour cette transaction à un stade ultérieur quand vous pourrez mettre à jour l’état de la transaction de votre côté.

COMPLETED

Le client a terminé la transaction avec succès du côté de SafetyPay.

FAILED

Le paiement a expiré du côté de SafetyPay.

Si vous ne recevez pas de webhooks, vous pouvez effectuer un appel GET pour demander l’état de la transaction. Toutefois, nous vous recommandons d’éviter d’interroger constamment l’API.

Voir Webhooks et appels GET pour de plus amples renseignements.

API à utiliser

Payment Handles Paiements

Exemple de code

Requête de Payment Handle

{



    "amount": 47000,

    "currencyCode": "CLP",

    "dupCheck": true,

    "liveMode": true,

    "merchantRefNum": "eb23d35f-761c-4496-8c01-0cd6a5a5be71",

    transactionType:"transactionType": "PAYMENT",

    "paymentExpiryMinutes":15,

    "accountId": "1002495260",

    "paymentType": "KHIPU",

    "profile": {

        "email": "CLKHIPU0212_01@gmail.com"

    },

    "returnLinks": [

        {

            "rel": "default",

            "href": "http://www.amazon.ca"

        }

    ]



}

Réponse du Payment Handle

{



    "id": "285cb0a7-58a4-4889-816f-7f4307901ceb",

    "paymentType": "KHIPU",

    "paymentHandleToken": "PHLDYzxhki41lc4H",

    "merchantRefNum": "b7500fd0-626c-41c6-9149-d1a763eb8b48",

    "currencyCode": "CLP",

    "txnTime": "2023-03-14T05:15:01Z",

    "customerIp": "213.208.158.220",

    "status": "INITIATED",

    "links": [

        {

            "rel": "redirect_payment",

            "href": "https://api.test.paysafe.com/alternatepayments/v1/redirect?accountId=1002495260&paymentHandleId=285cb0a7-58a4-4889-816f-7f4307901ceb&token=eyJhbGciOiJIUzI1NiJ9.eyJhY2QiOiIxMDAyNDk1MjYwIiwicHlkIjoiMjg1Y2IwYTctNThhNC00ODg5LTgxNmYtN2Y0MzA3OTAxY2ViIiwiZXhwIjoxNjc4NzcyNzAyfQ.L6of4dOnuo7wBjxJIizrwzsItCOhRzkXEa1AS2gL7kU"

        }

    ],

    "liveMode": false,

    "simulator": "EXTERNAL",

    "usage": "SINGLE_USE",

    "action": "REDIRECT",

    "executionMode": "SYNCHRONOUS",

    "amount": 47000,

    "timeToLiveSeconds": 898,

    "gatewayResponse": {

        "operationId": "0123073466283383",

        "id": "60edc2f9-5c33-4455-ab8c-edbe009a19fa",

        "processor": "SAFETYPAY"

    },

    "returnLinks": [

        {

            "rel": "default",

            "href": "http://www.amazon.ca"

        }

    ],

    transactionType:"transactionType": "PAYMENT",

    "gatewayReconciliationId": "60edc2f9-5c33-4455-ab8c-edbe009a19fa",

    "updatedTime": "2023-03-14T05:15:02Z",

    "statusTime": "2023-03-14T05:15:02Z",

    "paymentExpiryMinutes":15,

    "profile": {

        "email": "CLKHIPU0212_01@gmail.com"

    }



}

Requête de paiement

{



    "merchantRefNum": "40005e73-71e0-433a-8817-7604dfce884d",

    "amount": 47000,

    "currencyCode": "CLP",

    "dupCheck": true,

    "settleWithAuth": true,

    "paymentHandleToken": "PHLDYzxhki41lc4H"



}

Réponse de paiement

{



    "id": "3e7f67e6-8927-4aea-93ec-a159b194ac40",

    "paymentType": "KHIPU",

    "paymentHandleToken": "PHLDYzxhki41lc4H",

    "merchantRefNum": "0d6002cf-532d-4221-a230-b4227db3dc0a",

    "currencyCode": "CLP",

    "settleWithAuth": true,

    "dupCheck": true,

    "txnTime": "2023-03-14T05:15:01Z",

    "customerIp": "213.208.158.220",

    "status": "PROCESSING",

    "gatewayReconciliationId": "60edc2f9-5c33-4455-ab8c-edbe009a19fa",

    "amount": 47000,

    "availableToRefund": 0,

    "consumerIp": "213.208.158.220",

    "liveMode": false,

    "simulator": "EXTERNAL",

    "updatedTime": "2023-03-14T05:17:10Z",

    "statusTime": "2023-03-14T05:17:10Z",

    "gatewayResponse": {

        "operationId": "0123073466283383",

        "id": "60edc2f9-5c33-4455-ab8c-edbe009a19fa",

        "processor": "SAFETYPAY",

        "status": "101"

    },

    "availableToSettle": 0,

    "profile": {

        "email": "CLKHIPU0212_01@gmail.com"

    },

    "settlements": {

        "amount": 47000,

        "txnTime": "2023-03-14T05:15:01.000+0000",

        "availableToRefund": 0,

        "merchantRefNum": "0d6002cf-532d-4221-a230-b4227db3dc0a",

        "id": "3e7f67e6-8927-4aea-93ec-a159b194ac40",

        "status": "PROCESSING"

    }



}

Codes bancaires

Code du nom de la banque	Devises	Montant minimum	Montant maximum
KHIPU	CLP	200 CLP	5 000 000 CLP
BANCO_DE_CHILE	CLP	200 CLP	5 000 000 CLP
SANTANDER	CLP	1 000 CLP	5 000 000 CLP
BANCO_ESTADO	CLP	200 CLP	5 000 000 CLP
BCI	CLP	200 CLP	5 000 000 CLP
ITAU	CLP	200 CLP	5 000 000 CLP

Instructions de test

Pays	currencyCode	countryCode	Instructions
Chili	CLP	CL	Sur la page SafetyPay Express : Sélectionnez SP Test Bank Default pour la banque. Cliquez sur Effectuer le paiement. Vous serez redirigé vers la page de test de la banque : Saisissez test pour l’id utilisateur et test pour le mot de passe. Confirmez la transaction. -------------- Sur la page SafetyPay Express : Sélectionnez SP Test Bank Direct pour la banque. Cliquez sur Effectuer le paiement. Vous serez redirigé vers la page de test de la banque : Saisissez test pour l’id utilisateur et test pour le mot de passe. Sélectionnez Chili, Pesos pour la devise. Saisissez le « Code de paiement » de la page Safetypay Express pour l’ID de transaction. Saisissez le montant de la page Safetypay Express pour le montant. Cliquez sur Accepter pour confirmer la transaction.

Pays

currencyCode

countryCode

Instructions

Chili

CLP

Sur la page SafetyPay Express :
- Sélectionnez SP Test Bank Default pour la banque.
- Cliquez sur Effectuer le paiement.
Vous serez redirigé vers la page de test de la banque :
- Saisissez test pour l’id utilisateur et test pour le mot de passe.
- Confirmez la transaction.

--------------

Sur la page SafetyPay Express :
- Sélectionnez SP Test Bank Direct pour la banque.
- Cliquez sur Effectuer le paiement.
Vous serez redirigé vers la page de test de la banque :
- Saisissez test pour l’id utilisateur et test pour le mot de passe.
- Sélectionnez Chili, Pesos pour la devise.
- Saisissez le « Code de paiement » de la page Safetypay Express pour l’ID de transaction.
- Saisissez le montant de la page Safetypay Express pour le montant.
- Cliquez sur Accepter pour confirmer la transaction.

Cette page a-t-elle été utile ?

Sur cette page

Fonctionnalités
Exigences de configuration
Exigences en matière de certification
Types de transaction
Diagramme de flux des paiements
Scénarios habituels
Exemple de code
Requête de Payment Handle
Requête de paiement
Réponse de paiement
Codes bancaires
Instructions de test

Search Overlay

KHIPU

Liens renvoyés

Cette page a-t-elle été utile ?

Merci pour votre réponse!