Pix
PIX est un mode de paiement utilisé au Brésil, pris en charge par l’API Paiements de Paysafe. Grâce à PIX, les transactions peuvent être effectuées en moins de 10 secondes, 24 heures sur 24 et tous les jours de la semaine, y compris les fins de semaine et les jours fériés. Les utilisateurs qui choisissent cette option de paiement sur la page de paiement peuvent numériser un code QR avec un téléphone intelligent ou le copier-coller dans une application bancaire ou de portefeuille numérique. Il ne reste plus qu’à confirmer l’action et à vérifier les informations relatives au destinataire.
Fonctionnalités
Pix :
Acceptez les paiements des personnes sans compte bancaire
Confirmation instantanée du paiement
Pix ne présente aucun risque de rétrofacturation
Date d’expiration du code QR : si le code QR n’est pas payé dans les délais prévus, il expire et la transaction est annulée.
Vaste clientèle de 100 millions d’utilisateurs au Brésil
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 aurez accès à un portail où vous trouverez les renseignements suivants
- Clé secrète du marchand
- Clé de signature du marchand
- Vous aurez accès à un portail où vous trouverez les renseignements suivants
- Fournissez-nous ces renseignements pour créer votre clé API. Vous utiliserez cette clé d’API dans nos appels à l’API.
Exigences en matière de certification
Une procédure de certification est nécessaire pour que chaque marchand puisse utiliser 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 minimum : pas de montant minimum
Montant maximum : 1 000,00 R$
Devise de traitement : BRL
Devise de règlement : USD
Diagramme de flux des paiements
Scénarios habituels
Pour traiter une requête de paiement en utilisant Pix comme mode de paiement, procédez comme suit :
Créez un Payment handle avec le paramètre transactionType défini sur PAYMENT et le paramètre paymentType défini sur la valeur : PIX
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.
Une fois le paiement effectué par le client en ligne, le marchand reçoit une notification de paiement terminé via les webhooks.
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
{
"amount": 500,
"currencyCode": "BRL",
"dupCheck": true,
"merchantRefNum": "f1e79262-fdee-4e7c-bd5e-006063f07d28",
transactionType:"transactionType": "PAYMENT",
"paymentExpiryMinutes":15,
"accountId": "1002495220",
"paymentType": "PIX",
"profile": {
"email": "BRPIXQA0220_01@gmail.com"
},
"returnLinks": [
{
"rel": "default",
"href": "https://www.paysafe.com/en/"
}
]
}
Réponse du Payment Handle
{
"id": "d5b72dc1-4f2d-4dad-8299-ba2733073917",
"paymentType": "PIX",
"paymentHandleToken": "PHWPYAgGyPEnn56C",
"merchantRefNum": "3f5c68c5-ffa1-4e61-9399-9f17d2a0586f",
"currencyCode": "BRL",
"txnTime": "2023-03-14T08:05:43Z",
"customerIp": "213.208.158.220",
"status": "INITIATED",
"links": [
{
"rel": "redirect_payment",
"href": "https://api.test.paysafe.com/alternatepayments/v1/redirect?accountId=1002495220&paymentHandleId=d5b72dc1-4f2d-4dad-8299-ba2733073917&token=eyJhbGciOiJIUzI1NiJ9.eyJhY2QiOiIxMDAyNDk1MjIwIiwicHlkIjoiZDViNzJkYzEtNGYyZC00ZGFkLTgyOTktYmEyNzMzMDczOTE3IiwiZXhwIjoxNjc4NzcyMzI0fQ.F0Vv5w9xKezks7Kj8hJ1aYnInyxWZu2aPa3FhLC7jSA"
}
],
"liveMode": false,
"simulator": "EXTERNAL",
"usage": "SINGLE_USE",
"action": "REDIRECT",
"executionMode": "SYNCHRONOUS",
"amount": 500,
"timeToLiveSeconds": 898,
"gatewayResponse": {
"operationId": "0123073466231331",
"id": "17050834-913d-48aa-901f-fb5a377d3fde",
"processor": "SAFETYPAY"
},
"returnLinks": [
{
"rel": "default",
"href": "https://www.paysafe.com/en/"
}
],
transactionType:"transactionType": "PAYMENT",
"gatewayReconciliationId": "17050834-913d-48aa-901f-fb5a377d3fde",
"updatedTime": "2023-03-14T05:08:44Z",
"statusTime": "2023-03-14T05:08:44Z",
"paymentExpiryMinutes":15,
"profile": {
"email": "BRPIXQA0220_01@gmail.com"
}
}
Requête de paiement
{
"merchantRefNum": "915c1a0f-9380-40e6-b1a2-adc968b11efc",
"amount": 500,
"currencyCode": "BRL",
"dupCheck": true,
"settleWithAuth": true,
"paymentHandleToken": "PHWPYAgGyPEnn56C"
}
Réponse de paiement
{
"id": "c0b0a8cf-c706-4da8-8980-442a08dfdea2",
"paymentType": "PIX",
"paymentHandleToken": "PHWPYAgGyPEnn56C",
"merchantRefNum": "6b7dbb44-7bb1-4584-9707-a32f9be5bae5",
"currencyCode": "BRL",
"settleWithAuth": true,
"dupCheck": true,
"txnTime": "2023-03-14T05:11:55Z",
"customerIp": "213.208.158.220",
"status": "PROCESSING",
"gatewayReconciliationId": "d5685b03-9107-48dc-91b2-deba355ed8c3",
"amount": 500,
"availableToRefund": 0,
"consumerIp": "213.208.158.220",
"liveMode": false,
"simulator": "EXTERNAL",
"updatedTime": "2023-03-14T05:12:07Z",
"statusTime": "2023-03-14T05:12:07Z",
"gatewayResponse": {
"operationId": "0123073466280380",
"id": "d5685b03-9107-48dc-91b2-deba355ed8c3",
"processor": "SAFETYPAY",
"status": "101"
},
"availableToSettle": 0,
"profile": {
"email": "BRPIXQA0220_01@gmail.com"
},
"settlements": {
"amount": 500,
"txnTime": "2023-03-14T05:11:55.000+0000",
"availableToRefund": 0,
"merchantRefNum": "6b7dbb44-7bb1-4584-9707-a32f9be5bae5",
"id": "c0b0a8cf-c706-4da8-8980-442a08dfdea2",
"status": "PROCESSING"
}
}
Instructions de test
| Pays | currencyCode | countryCode | Instructions |
|---|---|---|---|
| Brésil | BRL | BR |
|