SafetyPay Cash
Avec SafetyPay Cash, vos clients peuvent sélectionner SafetyPay comme mode de paiement privilégié ainsi qu’une devise lorsqu’ils effectuent des achats en ligne ou par téléphone (via divers canaux de service, tels que le commerce électronique ou un centre d’appels). Ils reçoivent alors un code de paiement spécial qu’ils peuvent présenter à l’un des partenaires de paiement locaux de SafetyPay, parfois une banque locale.
L’API Paiements Paysafe prend en charge SafetyPay Cash via SafetyPay en tant qu’instrument de paiement pour les marchands de jeux en ligne et de cryptomonnaies dans les pays suivants :
- Brésil
- Chili
- Colombie
- Costa Rica
- Pérou
Fonctionnalités
SafetyPay Cash :
- Permet d’accepter les paiements des clients non bancarisés.
- Ne comporte aucun risque en matière de rétrofacturation.
- Vaste réseau de collecte dans 11 pays.
- Permet d’effectuer des paiements auprès des agences locales et des magasins de détail les plus populaires.
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.
Devises de traitement : BRL, CLP, COP, PEN, CRC
Devise de règlement : USD
Voir Codes bancaires ci-dessous, pour les détails des montants minimums et maximums des transactions, les montants minimums/maximums variant selon la banque choisie.
REMARQUE : CLP et COP n’ont pas d’unités monétaires mineures. 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 ou COP 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 SafetyPay Cash comme mode de paiement :
Créez un Payment Handle avec les paramètres suivants :
transactionType : PAYMENT
paymentType : SAFETYPAY_CASH
countryCode : puisque SafetyPay Cash est proposé dans de nombreux pays, vous devez transmettre le countryCode dans la requête. Voir Codes de pays ci-dessous.
bankNameCodes : en option, vous pouvez transmettre les bankNameCodes dans votre requête si vous souhaitez que le client puisse voir certaines banques dans SafetyPay Express. Voir Codes bancaires ci-dessous.Redirigez 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 par SafetyPay Cash sans codes bancaires :
{
"amount": 500,
"currencyCode": "BRL",
"merchantRefNum": "78c09d3e-f6c6-4c03-b8c0-4e21fb08f232",
transactionType:"transactionType": "PAYMENT",
"paymentExpiryMinutes": 20,
"accountId": "1002622950",
"paymentType": "SAFETYPAY_CASH",
"safetypayCash": {
"countryCode": "BR"
},
"profile": {
"email": "brlspcash@gmail.com"
},
"returnLinks": [
{
"rel": "default",
"href": "http://www.amazon.ca"
}
]
}
Requête de création d’un Payment Handle pour un paiement par SafetyPay Cash avec codes bancaires :
{
"amount": 500,
"currencyCode": "BRL",
"merchantRefNum": "78c09d3e-f6c6-4c03-b8c0-4e21fb08f232",
transactionType:"transactionType": "PAYMENT",
"paymentExpiryMinutes": 20,
"accountId": "1002622950",
"paymentType": "SAFETYPAY_CASH",
"safetypayCash": {
"countryCode": "BR",
"bankNameCodes":[
"LOTERICAS"
]
},
"profile": {
"email": "brlspcash@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": "42517a01-94a7-484d-9040-5a09c0898101",
"paymentType": "SAFETYPAY_CASH",
"paymentHandleToken": "PH72waPqDtaxmRzj",
"merchantRefNum": "57e8b2d3-ad2c-4a79-ae1f-7e7752cbe8d0",
"currencyCode": "BRL",
"txnTime": "2023-03-14T05:24:56Z",
"customerIp": "213.208.158.220",
"status": "INITIATED",
"links": [
{
"rel": "redirect_payment",
"href": "https://api.test.paysafe.com/alternatepayments/v1/redirect?accountId=1002622950&paymentHandleId=42517a01-94a7-484d-9040-5a09c0898101&token=eyJhbGciOiJIUzI1NiJ9.eyJhY2QiOiIxMDAyNjIyOTUwIiwicHlkIjoiNDI1MTdhMDEtOTRhNy00ODRkLTkwNDAtNWEwOWMwODk4MTAxIiwiZXhwIjoxNjc4NzczMjk4fQ.zcnmnkOHeEVYzmqTr-X94XY-p5WJX8ZsRS-k114i1oU"
}
],
"liveMode": false,
"simulator": "EXTERNAL",
"usage": "SINGLE_USE",
"action": "REDIRECT",
"executionMode": "SYNCHRONOUS",
"amount": 500,
"timeToLiveSeconds": 898,
"gatewayResponse": {
"operationId": "0123073466308408",
"id": "7401a4ac-9737-4c9b-bd7a-3a95bceecccd",
"processor": "SAFETYPAY"
},
"returnLinks": [
{
"rel": "default",
"href": "http://www.amazon.ca"
}
],
transactionType:"transactionType": "PAYMENT",
"gatewayReconciliationId": "7401a4ac-9737-4c9b-bd7a-3a95bceecccd",
"updatedTime": "2023-03-14T05:24:58Z",
"statusTime": "2023-03-14T05:24:58Z",
"safetypayCash": {
"countryCode": "BR"
},
"profile": {
"email": "brlspcash@gmail.com"
}
}
Requête de paiement
Requête de paiement par SafetyPay Cash à l’aide du paymentHandleToken reçu dans la réponse du Payment Handle :
{
"merchantRefNum": "daf6947b-3ee1-421a-bea8-dc5bcd45b678",
"amount": 500,
"currencyCode": "BRL",
"dupCheck": true,
"settleWithAuth": true,
"paymentHandleToken": "PH72waPqDtaxmRzj"
}
Réponse pour paiement
Réponse à une requête de paiement par SafetyPay Cash :
{
"id": "f6f69572-90da-4e41-bdd6-de7e3f7787d3",
"paymentType": "SAFETYPAY_CASH",
"paymentHandleToken": "PH72waPqDtaxmRzj",
"merchantRefNum": "1b9d0b1c-ce9a-44e6-9c2e-ef668f40f6b3",
"currencyCode": "BRL",
"settleWithAuth": true,
"dupCheck": true,
"txnTime": "2023-03-14T05:24:56Z",
"customerIp": "213.208.158.220",
"status": "PROCESSING",
"gatewayReconciliationId": "7401a4ac-9737-4c9b-bd7a-3a95bceecccd",
"amount": 500,
"availableToRefund": 0,
"consumerIp": "213.208.158.220",
"liveMode": false,
"simulator": "EXTERNAL",
"updatedTime": "2023-03-14T05:25:56Z",
"statusTime": "2023-03-14T05:25:56Z",
"gatewayResponse": {
"operationId": "0123073466308408",
"id": "7401a4ac-9737-4c9b-bd7a-3a95bceecccd",
"processor": "SAFETYPAY",
"status": "101"
},
"availableToSettle": 0,
"profile": {
"email": "brlspcash@gmail.com"
},
"settlements": {
"amount": 500,
"txnTime": "2023-03-14T05:24:56.000+0000",
"availableToRefund": 0,
"merchantRefNum": "1b9d0b1c-ce9a-44e6-9c2e-ef668f40f6b3",
"id": "f6f69572-90da-4e41-bdd6-de7e3f7787d3",
"status": "PROCESSING"
}
}
Codes de pays
Transmettez le code du pays concerné dans votre requête de Payment Handle :
| Pays | Code de pays |
|---|---|
| Brésil | BR |
| Chili | CL |
| Colombie | CO |
| Costa Rica | CR |
| Pérou | PE |
Codes bancaires
Utilisez les codes suivants dans vos requêtes de Payment Handle si vous souhaitez afficher les noms des banques à vos clients :
| Code du nom de la banque | Devises | Montant minimum | Montant maximum |
|---|---|---|---|
| LOTERICAS | BRL | Pas de montant minimum | 57 000 BRL |
| BRADESCO | BRL | Pas de montant minimum | 5 000 BRL |
| BANCO_ESTADO | CLP | Pas de montant minimum | 8 500 000 CLP |
| CAJA_VECINA | CLP | Pas de montant minimum | 8 500 000 CLP |
| BANCO_ESTADO_EXPRESS | CLP | Pas de montant minimum | 8 500 000 CLP |
| WALMART_CHILE | CLP | Pas de montant minimum | 3 000 000 CLP |
| LIDER | CLP | Pas de montant minimum | 3 000 000 CLP |
| EXPRESS_DE_LIDER | CLP | Pas de montant minimum | 3 000 000 CLP |
| ACUENTA | CLP | Pas de montant minimum | 3 000 000 CLP |
| EFECTY | COP | S.O. | 6 000 000 COP |
| MOVILRED_COLOMBIA | COP | S.O. | 1 000 000 COP |
| SURED | COP | S.O. | 4 000 000 COP |
| PAGA_TODO_PARA_TODO | COP | S.O. | 4 000 000 COP |
| GANA_GANA | COP | S.O. | 4 000 000 COP |
| GANA | COP | S.O. | 4 000 000 COP |
| DIMONEX | COP | S.O. | 6 000 000 COP |
| APUESTAS_UNIDAS | COP | S.O. | 4 000 000 COP |
| APUESTAS_CUCUTA_75 | COP | S.O. | 4 000 000 COP |
| LA_PERLA | COP | S.O. | 4 000 000 COP |
| SUCHANCE | COP | S.O. | 4 000 000 COP |
| ACERTEMOS | COP | S.O. | 4 000 000 COP |
| JER | COP | S.O. | 4 000 000 COP |
| ACCIONES_Y_VALORESACCIONES_Y_VALORES | COP | S.O. | 25 000 000 COP |
| PUNTO_RED | COP | S.O. | 800 000 COP |
| PUNTO_DE_PAGO | COP | S.O. | 4 000 000 COP |
| CREDIBANCO | COP | S.O. | 300 000 COP |
| FULL_CARGA | COP | S.O. | 3 000 000 COP |
| REDEBAN | COP | S.O. | 300 000 COP |
| BANCO_NACIONAL_DE_COSTA_RICA | CRC | 637 CRC | 6 200 000 CRC |
| BBVA_CONTINENTALBBVA_CONTINENTAL | PEN | Pas de montant minimum | 1 900 Agentes PEN |
| BANCO_DE_CREDITO | PEN | Pas de montant minimum | 1 000 Agentes PEN |
| SCOTIABANK | PEN | Pas de montant minimum | 5 000 Agentes PEN |
| INTERBANK | PEN | Pas de montant minimum | 700 Agentes PEN |
| CAJA_TACNA_PERU | PEN | 10 PEN | 43 000 PEN |
| CAJA_TRUJILLO_PERU | PEN | Pas de montant minimum | 43 000 PEN |
| CAJA_HUANCAYO_PERU | PEN | Pas de montant minimum | 43 000 PEN |
| WESTERN_UNION | PEN | Pas de montant minimum | 43 000 PEN |
| BANCO_RIPLEY | PEN | Pas de montant minimum | 43 000 PEN |
| CAJA_AREQUIPA | PEN | Pas de montant minimum | 43 000 PEN |
| TAMBO | PEN | 1 PEN | 500 PEN |
| KASNET | PEN | 1 PEN | 1 000 PEN |
| AGENTE_NIUBIZ | PEN | 1 PEN | 500 PEN |
Instructions de test
| Pays | currencyCode | countryCode | Instructions |
|---|---|---|---|
| Brésil | BRL | BR |
|
| Chili | CLP | CL | |
| Colombie | COP | CO | |
| Costa Rica | CRC | CR | |
| Pérou | PEN | PE |