MACH
MACH est un mode de paiement par code QR utilisé au Chili. Fourni par une banque numérique créée en tant que filiale de Banco Bci, MACH est un compte numérique prépayé et gratuit. Il fonctionne comme un portefeuille numérique en permettant aux utilisateurs de payer des transactions physiques ou numériques à l’aide de leur téléphone intelligent. Les utilisateurs peuvent terminer le paiement dans l’application MACH en numérisant un code QR après avoir choisi cette option de paiement sur la page de paiement.
L’API Paiements de Paysafe prend en charge MACH via SafetyPay en tant qu’instrument de paiement pour les marchands de jeux électroniques et de cryptomonnaies au Chili.
Fonctionnalités
MACH :
- Permet d’accepter les paiements des clients non bancarisés.
- Confirmation instantanée du paiement.
- Ne comporte aucun risque en matière de rétrofacturation.
- Plus de 3 millions d’utilisateurs au Chili
Exigences de configuration
Pour créer des comptes dans les environnements de bac à sable et de production :
- Envoyez vos renseignements à it_integrations@safetypay.com
Vous recevrez un accès à un portail où vous pourrez accéder aux clés suivantes :- Clé secrète du marchand
- Clé de signature du marchand
- Fournissez-nous ces renseignements pour créer votre clé API. Vous utiliserez cette clé d’API dans vos appels à l’API.
Votre gestionnaire de compte vous guidera tout au long de ce processus.
Exigences en matière de certification
Vous devez suivre une procédure de certification pour pouvoir utiliser Safetypay Express comme mode de paiement.
L’équipe d’intégration de Paysafe vous communiquera les exigences de certification.
Types de transaction
Paysafe prend en charge les types de transactions suivants :
- Paiements : pour transférer de l’argent du compte bancaire d’un client vers votre compte marchand. Après un paiement réussi, vous créditez le portefeuille du client.
Montant minimum : pas de montant minimum
Montant maximum : 500 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 demande de paiement en utilisant MACH comme mode de paiement :
Créez un Payment Handle avec les paramètres suivants :
transactionType : PAYMENT
PaymentType : MACHRedirigez le client vers l’URL de redirection SafetyPay afin qu’il puisse générer un code de paiement.
L’état du Payment Handle passera à PAYABLE; vous serez notifié de ce changement d’état via les webhooks que vous aurez 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.
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.
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. |
API à utiliser
Exemple de code
Requête de Payment Handle
Requête de création d’un Payment Handle pour un paiement MACH :
{
"amount": 500,
"currencyCode": "CLP",
"dupCheck": true,
"liveMode": true,
"merchantRefNum": "32e74478-37a3-46ac-ba2f-019b8c057432",
transactionType:"transactionType": "PAYMENT",
"paymentExpiryMinutes":15,
"accountId": "1002495250",
"paymentType": "MACH",
"profile": {
"email": "CLMACH0212_01@gmail.com"
},
"returnLinks": [
{
"rel": "default",
"href": "http://www.amazon.ca"
}
]
}
Réponse du Payment Handle
Réponse à une requête de création de gestionnaire de paiement :
{
"id": "8fc01ce1-469e-423d-b232-d915fd0c0158",
"paymentType": "MACH",
"paymentHandleToken": "PHivZQUor3tAMihh",
"merchantRefNum": "7f9ecf57-f82a-47cd-89cd-d67369b53b9b",
"currencyCode": "CLP",
"txnTime": "2023-03-14T05:18:09Z",
"customerIp": "213.208.158.220",
"status": "INITIATED",
"links": [
{
"rel": "redirect_payment",
"href": "https://api.test.paysafe.com/alternatepayments/v1/redirect?accountId=1002495250&paymentHandleId=8fc01ce1-469e-423d-b232-d915fd0c0158&token=eyJhbGciOiJIUzI1NiJ9.eyJhY2QiOiIxMDAyNDk1MjUwIiwicHlkIjoiOGZjMDFjZTEtNDY5ZS00MjNkLWIyMzItZDkxNWZkMGMwMTU4IiwiZXhwIjoxNjc4NzcyODkxfQ.ojD3jqncSz372DTaaA9tCow6LQmY3bTese0To5_vf5M"
}
],
"liveMode": false,
"simulator": "EXTERNAL",
"usage": "SINGLE_USE",
"action": "REDIRECT",
"executionMode": "SYNCHRONOUS",
"amount": 500,
"timeToLiveSeconds": 898,
"gatewayResponse": {
"operationId": "0123073466297397",
"id": "b0c70d4c-3f90-4fd9-be0e-393fcac48528",
"processor": "SAFETYPAY"
},
"returnLinks": [
{
"rel": "default",
"href": "http://www.amazon.ca"
}
],
transactionType:"transactionType": "PAYMENT",
"gatewayReconciliationId": "b0c70d4c-3f90-4fd9-be0e-393fcac48528",
"updatedTime": "2023-03-14T05:18:11Z",
"statusTime": "2023-03-14T05:18:11Z",
"paymentExpiryMinutes":15,
"profile": {
"email": "CLMACH0212_01@gmail.com"
}
}
Requête de paiement
Requête de paiement MACH à l’aide du paymentHandleToken reçu dans la réponse du Payment Handle :
{
"merchantRefNum": "32a2cb08-9167-403c-a5e3-e850cb97a462",
"amount": 500,
"currencyCode": "CLP",
"dupCheck": true,
"settleWithAuth": true,
"paymentHandleToken": "PHivZQUor3tAMihh"
}
Réponse pour paiement
Réponse à une requête de paiement MACH :
{
"id": "bed02d59-6723-44fe-9149-9b0cb98245fd",
"paymentType": "MACH",
"paymentHandleToken": "PHivZQUor3tAMihh",
"merchantRefNum": "01440e1d-325f-4f84-a539-85b3e918e78e",
"currencyCode": "CLP",
"settleWithAuth": true,
"dupCheck": true,
"txnTime": "2023-03-14T05:18:09Z",
"customerIp": "213.208.158.220",
"status": "PROCESSING",
"gatewayReconciliationId": "b0c70d4c-3f90-4fd9-be0e-393fcac48528",
"amount": 500,
"availableToRefund": 0,
"consumerIp": "213.208.158.220",
"liveMode": false,
"simulator": "EXTERNAL",
"updatedTime": "2023-03-14T05:19:30Z",
"statusTime": "2023-03-14T05:19:30Z",
"gatewayResponse": {
"operationId": "0123073466297397",
"id": "b0c70d4c-3f90-4fd9-be0e-393fcac48528",
"processor": "SAFETYPAY",
"status": "101"
},
"availableToSettle": 0,
"profile": {
"email": "CLMACH0212_01@gmail.com"
},
"settlements": {
"amount": 500,
"txnTime": "2023-03-14T05:18:09.000+0000",
"availableToRefund": 0,
"merchantRefNum": "01440e1d-325f-4f84-a539-85b3e918e78e",
"id": "bed02d59-6723-44fe-9149-9b0cb98245fd",
"status": "PROCESSING"
}
}
Instructions de test
| Pays | currencyCode | countryCode | Instructions |
|---|---|---|---|
| Chili | CLP | CL |
--------------
|