À propos de PagoEfectivo

Aperçu

Les acheteurs en ligne au Pérou peuvent régler leurs achats en utilisant l’option de paiement PagoEfectivo sans utiliser de carte de crédit ou de débit. Le client choisit le mode de paiement PagoEfectivo lors de la commande et reçoit un code spécial (dans sa boîte de réception de courrier électronique). Le client peut ensuite accéder à sa plateforme bancaire en ligne pour effectuer la transaction (en utilisant le code comme référence spéciale de la transaction) ou opter pour un paiement hors ligne dans l’un des 40 000 points de vente physiques qui acceptent les paiements en argent comptant pour PagoEfectivo.

L’API Paiements Paysafe prend en charge PagoEfectivo, un mode de paiement populaire au Pérou et en Équateur. Il permet aux clients d’effectuer des paiements en espèces ou par virement bancaire. Les clients peuvent effectuer un paiement à l’aide d’un code CIP généré soit via leur banque en ligne/mobile, soit en personne dans plus de 140 000 points de vente (comme les bureaux de poste, les agents de loterie et divers autres lieux autorisés).

Exigences de configuration

Pour que Paysafe puisse créer un compte de test dans les environnements de bac à sable et de production, les informations suivantes sont nécessaires.

Clé API Paysafecard

Types de transaction

Paiements

Avantages

Accepter les paiements des clients sans compte bancaire
Solutions eCash et de banque en ligne
PagoEfectivo ne présente aucun risque de rétrofacturation
Date d’expiration du code CIP. Si le code CIP n’est pas utilisé dans le délai imparti, il expire et la transaction est annulée.
15 % de part de marché au Pérou

PÉROU

PÉROU

Portefeuilles QR – Yape, Plin, BBVA Wallet, Scotiabank, Interbank, Ligo, BanBif et Tunki.
Banque mobile/Internet – BBVA, BCP, Scotiabank, Interbank, BanBif, Caja Arequipa et Banco Pichincha, par le biais de la banque en ligne ou de la banque mobile dans l’option de paiement du service.
Agences et entrepôts – BBVA, BCP, Interbank, Scotiabank, BanBif, Western Union, Tambo+, Kasnet, Ya Ganaste, Red Digital, Niubiz Multiservice Commerce, MoneyGram, Caja Arequipa, Disashop, Cellpower.
currencyCode: PEN
paymentType: PAGOEFECTIVO

MONTANT EN SOLS PÉRUVIENS
Montant minimum	Montant maximum
S/.2	S/.3,724*

* S/.250, montant maximum avec Disashop
S/.500, montant maximum avec Scotiabank, Caja Arequipa, Ya Ganaste, Red Digital, Niubiz, Cellpower
S/.700, montant maximum avec Interbank
S/.1 000, montant maximum avec Kasnet, argent comptant
S/.1 500, montant maximum avec Western Union, Caja del Santa, Payment Network, Caja Paita, Caja Sullana, Caja Trujillo, Raiz

ÉQUATEUR

ÉQUATEUR

Banque par Internet – Azuayo Garden.
Agences – Western Union RedActiva (*), Puntos Facilito, Mi Negocio Efectivo, Ponle + (*), Almacenes TIA (*), Mi comisariato (*), Servientrega (*), Farmacias 911 (*), Banco Amazonas, Coac 29 Octubre, Orocash, Multipagos, Cnt, Fullcarga and Ya Ganaste.
currencyCode: USD
paymentType: PAGOEFECTIVO

(*) L’approbation du paiement sera notifiée après 20 minutes. Les heures d’ouverture et le montant du paiement dépendent de chaque établissement.

ÉQUATEUR

MONTANT EN DOLLARS AMÉRICAINS DANS L’API PAIEMENTS
Montant minimum	Montant maximum
0,5 $	941 $*

MONTANT EN DOLLARS AMÉRICAINS EN CAISSE V2
Montant minimum	Montant maximum
1 $	941 $*

Montant maximum de 300 $ avec Red Activa, Mi Negocio Efectivo, Ponle+, Almacenes Tia, Mi Comisariato, Farmacias 911, Orocash, Multipago, Fullcarga, Ya Ganaste
Montant maximum de 600 $ avec Banco Amazonas, La 29, Cnt, Jardin Azuayo
Montant maximum de 700 $ avec Red de Agentes Facilito, Servientrega
Remarque : Les limites de montant peuvent varier en fonction du taux de change.

Diagramme de flux des paiements

Scénarios habituels

Paiement PagoEfectivo

Pour traiter une requête de paiement en utilisant PagoEfectivo 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 suivante : PAGOEFECTIVO
Redirigez le client vers l’URL de redirection PagoEfectivo 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é avec succès par le client en ligne ou en magasin, le marchand reçoit une notification de paiement terminé via les webhooks.

"Payment Handles", paiements

"Payment Handles" Paiements

API Contrats

Exemple de création d’un "payment handle"

{

    "paymentType": "PAGOEFECTIVO",

    "pagoefectivo": {

        "consumerId": "merchantclientid5HzDvoZSodKDJ7X7VQ"

    },

    "transactionType": "PAYMENT",

    "amount": 2500,

    "currencyCode": "PEN",

    "profile": {

        "firstName": "Account",

        "lastName": "Holder",

        "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"

        }

    ]

}

Exemple d’URL de redirection PagoEfectivo pour générer un code de paiement

{

    "id": "18d2744e-c2ee-4a05-a047-14c2d65f1eee",

    "paymentType": "PAGOEFECTIVO",

    "paymentHandleToken": "PHe8P6OlmlugCAlr",

    "merchantRefNum": "1653044860375",

    "currencyCode": "PEN",

    "txnTime": "2022-08-19T08:32:29Z",

    "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=1020436290&paymentHandleId=18d2744e-c2ee-4a05-a047-14c2d65f1eee&token=eyJhbGciOiJIUzI1NiJ9.eyJhY2QiOiIxMDIwNDM2MjkwIiwicHlkIjoiMThkMjc0NGUtYzJlZS00YTA1LWEwNDctMTRjMmQ2NWYxZWVlIiwiZXhwIjoxNjYwODk5NzQ5fQ.uNm3b4uFbQQmwIayRsmFTXWw9Ep7chfV8SIH2VUqI_M"

        }

    ],

    "liveMode": false,

    "simulator": "EXTERNAL",

    "usage": "SINGLE_USE",

    "action": "REDIRECT",

    "executionMode": "ASYNCHRONOUS",

    "amount": 2500,

    "merchantDescriptor": {

        "dynamicDescriptor": "Test Description",

        "phone": "5555345456"

    },

    "timeToLiveSeconds": 599,

    "gatewayResponse": {

        "processor": "PAYSAFECARD",

        "id": "pay_1020014799_Q9CeemLElvgzKRUeBl3DB85Hw3gqgqVz_PEN"

    },

    "returnLinks": [

        {

            "rel": "on_completed",

            "href": "https://api.dev.paysafe.com/checkout/v2/pages/redirect-success.html"

        },

        {

            "rel": "on_failed",

            "href": "https://api.dev.paysafe.com/checkout/v2/pages/redirect-error.html"

        },

        {

            "rel": "default",

            "href": "https://api.dev.paysafe.com/checkout/v2/pages/redirect-success.html"

        }

    ],

    "transactionType": "PAYMENT",

    "gatewayReconciliationId": "pay_1020014799_Q9CeemLElvgzKRUeBl3DB85Hw3gqgqVz_PEN",

    "updatedTime": "2022-08-19T08:32:29Z",

    "statusTime": "2022-08-19T08:32:29Z",

    "pagoefectivo": {

        "consumerId": "merchantclientid5HzDvoZSodKDJ7X7VQ"

    },

    "shippingDetails": {

        "recipientName": "Vishnu",

        "street": "20735 Stevens Creek Blvd",

        "street2": "Montessori",

        "city": "Cupertino",

        "state": "CA",

        "country": "US",

        "zip": "95014"

    },

    "profile": {

        "firstName": "Account",

        "lastName": "Holder",

        "email": "accountholder0@example.com",

        "dateOfBirth": {

            "day": 23,

            "month": 12,

            "year": 1990

        },

        "phone": "1234567890"

    }

}

Traiter la requête de paiement en utilisant paymentHandleToken

{

  "merchantRefNum": "1653044860376",

  "amount": 2500,

  "currencyCode": "PEN",

  "dupCheck": true,

  "settleWithAuth": true,

  "paymentHandleToken": "PHe8P6OlmlugCAlr",

  "customerIp": "172.0.0.1",

  "description": "Test Paysafe"

}

Notification de paiement terminé via les Webhooks

{

    "id": "aec0f8a5-a33b-49a3-ae25-9501ebf6e17f",

    "paymentType": "PAGOEFECTIVO",

    "paymentHandleToken": "PHe8P6OlmlugCAlr",

    "merchantRefNum": "1653044860375",

    "currencyCode": "PEN",

    "settleWithAuth": true,

    "dupCheck": false,

    "txnTime": "2022-08-19T08:32:29Z",

    "billingDetails": {

        "street1": "100",

        "street2": "Queen Street",

        "city": "Cupertino",

        "zip": "14236",

        "state": "NY",

        "country": "US"

    },

    "status": "PROCESSING",

    "gatewayReconciliationId": "pay_1020014799_Q9CeemLElvgzKRUeBl3DB85Hw3gqgqVz_PEN",

    "amount": 2500,

    "availableToRefund": 0,

    "consumerIp": "10.195.57.168",

    "liveMode": false,

    "simulator": "EXTERNAL",

    "updatedTime": "2022-08-19T08:33:03Z",

    "statusTime": "2022-08-19T08:33:03Z",

    "gatewayResponse": {

        "processor": "PAYSAFECARD",

        "id": "pay_1020014799_Q9CeemLElvgzKRUeBl3DB85Hw3gqgqVz_PEN"

    },

    "availableToSettle": 0,

    "pagoefectivo": {

        "consumerId": "merchantclientid5HzDvoZSodKDJ7X7VQ"

    },

    "shippingDetails": {

        "recipientName": "Vishnu",

        "street": "20735 Stevens Creek Blvd",

        "street2": "Montessori",

        "city": "Cupertino",

        "state": "CA",

        "country": "US",

        "zip": "95014"

    },

    "profile": {

        "firstName": "Account",

        "lastName": "Holder",

        "email": "accountholder0@example.com",

        "dateOfBirth": {

            "day": 23,

            "month": 12,

            "year": 1990

        },

        "phone": "1234567890"

    },

    "settlements": {

        "amount": 2500,

        "txnTime": "2022-08-19T08:32:29.000+0000",

        "availableToRefund": 0,

        "merchantRefNum": "1653044860375",

        "id": "aec0f8a5-a33b-49a3-ae25-9501ebf6e17f",

        "status": "RECEIVED"

    }

}

Pour en savoir plus sur chaque paramètre, vous pouvez consulter la rubrique Paiements.

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

Sur cette page

Aperçu
Types de transaction
Avantages
Diagramme de flux des paiements
Exemple de création d’un "payment handle"
Exemple d’URL de redirection PagoEfectivo pour générer un code de paiement
Notification de paiement terminé via les Webhooks

Search Overlay

À propos de PagoEfectivo

Banques en ligne et réseau de recouvrement

ÉQUATEUR

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

Merci pour votre réponse!