PagBank | DEUNA Docs

Sur cette page

Intégrer Pagbank
Considérations particulières et limites
Ressources d ' essai

Cette page fournit un guide pour intégrer PagBank à DEUNA.

Opérations prises en charge

L'intégration de PagBank dans votre stratégie de paiement avec DEUNA vous permet d'effectuer les opérations suivantes :

Autorisation
Capture complète
Captures partielles
Achat (capturé automatiquement)
Remboursement partiel (jusqu'à un par commande)
Remboursement intégral
Vide
3DS DEUNA

Méthodes de paiement prises en charge

Cartes:

Visa
Carte Master
Dîners
Amex
Élo

Pays et devises actifs

Brésil (BRL)

Exigences

Contactez votre représentant Pagbank et demandez les justificatifs suivants :

Vos références PagBank

Assurez-vous que votre compte est correctement configuré du côté Pagbank.

Intégrer Pagbank#

Intégrer PagBank dans DEUNA

1. Cherchez Pagbank dans DEUNA

Recherchez la connexion PagBank dans votre administrateur DEUNA et cliquez dessus.

Exemple interactifUtilise des données fictives et n’effectue aucune requête API.

Paiements

Connexions

Découvrez et gérez les intégrations de paiement, de portefeuille et antifraude.

Acme LATAM · Production

Rechercher des connexions

Connexions	Type	Statut
Adyen	Passerelle de paiement	Connectée
Worldpay	Passerelle de paiement	Connectée
PayPal	Moyen de paiement	Connectée
Mercado Pago	Moyen de paiement	Non connectée
Riskified	Moteur antifraude	Non connectée

2. Configurer PagBank dans votre magasin

Après avoir cherché Pagbank dans Connections, vous devez configurer Pagbank dans votre boutique.

Dans Connexions, une fenêtre comme celle-ci s'ouvrira :

Saisissez les informations d'identification suivantes :
- Dans Nom entrez un nom pour référencer les informations d'identification.
- Dans Devise sélectionnez la devise du processeur marchand disponible.
- Dans Merchant ID saisir un ID pour référencer le titre de compétence.
- Dans Clé privée entrer la clé privée de Pagbank.
Choisissez le type d'opération que vous souhaitez effectuer :
- Achat
- Autorisation
Pour activer votre connexion via l'API Connect de PagBank, vérifiez Pouvoirs de Deuna checkbox.
Choisissez si vous souhaitez activer la 3DS.
Cliquez Se connecter.

3. Autoriser PagBank via API

Si vous avez choisi de vous connecter via l'API Connect de PagBank :

Le portail Deuna vous redirigera vers le portail Pagbank pour compléter la connexion.
Entrez votre utilisateur PagBank et votre mot de passe.

Une fois la connexion effectuée dans votre compte, autorisez la connexion.

Une fois les étapes terminées, vous verrez un message de réussite.

4. Traitement des paiements dans PagBank

Vous verrez la connexion Pagbank dans l'onglet Connexions actives.

À partir de ce moment, vous pouvez maintenant traiter les transactions avec Pagbank via DEUNA.

Achat V2

JSON

{
    "payer_info": {
        "email": "omar_guzhnay@gmail.com"
    },
    "order_type": "DEUNA_NOW",
    "payment_source": {
        "method_type": "credit_card",
        "card_info": {
            "expiry_month": "12",
            "expiry_year": "2026",
            "card_holder_dni": "12345678000195",
            "card_holder": "Omar Guzhnay",
            "card_number": "4024007197692931",
            "card_cvv": "123",
            "address1": "Rua Visconde de Pirajá, 123, apto 12",
            "address2": "apto 12",
            "zip": "22410001",
            "city": "MIGUEL HIDALGO",
            "state": "CIUDAD DE MÉXICO",
            "country": "BR",
            "phone": "+5511985176644",
            "installments": 1
        }
    },
    "order": {
        "order_id": "a7c1d6c6-9a36-49b1-8cee-dd5434f3d270",
        "currency": "BRL",
        "statement_descriptor":"test",
        "market_type": "ecommerce",
        "items": [
            {
                "id": "00ab2d23-f44a-4782-aa7c-bb4fadeddfe3",
                "name": "Item #1",
                "description": "Description Item #1",
                "total_amount": {
                    "original_amount": 115000,
                    "amount": 115000,
                    "total_discount": 0,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "unit_price": {
                    "amount": 100000,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "tax_amount": {
                    "amount": 15000,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "quantity": 1,
                "image_url": "https://cdn.prod.website-files.com/66269d6696cb4969aa25e070/662d847fb61e3145e2b2f640_Logo%20DEUNA.svg",
                "taxable": true
            },
            {
                "id": "3cb41aec-1be8-4255-a386-94bb316a8157",
                "name": "Item #2",
                "description": "Description Item #2",
                "total_amount": {
                    "original_amount": 115000,
                    "amount": 115000,
                    "total_discount": 0,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "unit_price": {
                    "amount": 100000,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "tax_amount": {
                    "amount": 15000,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "quantity": 1,
                "image_url": "https://cdn.prod.website-files.com/66269d6696cb4969aa25e070/662d847fb61e3145e2b2f640_Logo%20DEUNA.svg",
                "taxable": true
            }
        ],
        "sub_total": 200000,
        "tax_amount": 30000,
        "total_tax_amount": 30000,
        "total_amount": 230000,
        "store_code": "all",
        "billing_address": {
            "id": "4255",
            "first_name": "Omar",
            "last_name": "Guzhnay",
            "email": "omar_guzhnay@gmail.com",
            "address1": "Rua Visconde de Pirajá, 123, apto 12",
            "address2": "apto 12",
            "zipcode": "22410001",
            "city": "Rio de Janeiro",
            "state_code": "RJ",
            "state_name": "Rio de Janeiro",
            "country_code": "BR",
            "identity_document": "12345678000195",
            "identity_document_type": "CNPJ",
            "phone": "+5511985176644",
            "lat": -22.943934,
            "lng": -43.182984,
            "additional_description": "confirm",
            "address_type": "home"
        }
    }
}

Demande avec récurrence

JSON

{
    "payer_info": {
        "email": "omar_guzhnay@gmail.com"
    },
    "order_type": "DEUNA_NOW",
    "payment_source": {
        "method_type": "credit_card",
        "card_info": {
            "expiry_month": "12",
            "expiry_year": "2026",
            "card_holder_dni": "12345678000195",
            "card_holder": "Omar Guzhnay",
            "card_number": "4024007197692931",
            "card_cvv": "123",
            "address1": "Rua Visconde de Pirajá, 123, apto 12",
            "address2": "apto 12",
            "zip": "22410001",
            "city": "MIGUEL HIDALGO",
            "state": "CIUDAD DE MÉXICO",
            "country": "BR",
            "phone": "+5511985176644",
            "installments": 1
        }
    },
    "order": {
        "order_id": "6eab785f-c0c6-4e04-9021-b296b8a36611",
        "currency": "BRL",
        "statement_descriptor":"test",
        "market_type": "ecommerce",
        "recurrence": {
            "first_time_use": true   //true = first or false=subsequent
        },
        "items": [
            {
                "id": "00ab2d23-f44a-4782-aa7c-bb4fadeddfe3",
                "name": "Item #1",
                "description": "Description Item #1",
                "total_amount": {
                    "original_amount": 115000,
                    "amount": 115000,
                    "total_discount": 0,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "unit_price": {
                    "amount": 100000,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "tax_amount": {
                    "amount": 15000,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "quantity": 1,
                "image_url": "https://cdn.prod.website-files.com/66269d6696cb4969aa25e070/662d847fb61e3145e2b2f640_Logo%20DEUNA.svg",
                "taxable": true
            },
            {
                "id": "3cb41aec-1be8-4255-a386-94bb316a8157",
                "name": "Item #2",
                "description": "Description Item #2",
                "total_amount": {
                    "original_amount": 115000,
                    "amount": 115000,
                    "total_discount": 0,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "unit_price": {
                    "amount": 100000,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "tax_amount": {
                    "amount": 15000,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "quantity": 1,
                "image_url": "https://cdn.prod.website-files.com/66269d6696cb4969aa25e070/662d847fb61e3145e2b2f640_Logo%20DEUNA.svg",
                "taxable": true
            }
        ],
        "sub_total": 200000,
        "tax_amount": 30000,
        "total_tax_amount": 30000,
        "total_amount": 230000,
        "store_code": "all",
        "billing_address": {
            "id": "4255",
            "first_name": "Omar",
            "last_name": "Guzhnay",
            "email": "omar_guzhnay@gmail.com",
            "address1": "Rua Visconde de Pirajá, 123, apto 12",
            "address2": "apto 12",
            "zipcode": "22410001",
            "city": "Rio de Janeiro",
            "state_code": "RJ",
            "state_name": "Rio de Janeiro",
            "country_code": "BR",
            "identity_document": "12345678000195",
            "identity_document_type": "CNPJ",
            "phone": "+5511985176644",
            "lat": -22.943934,
            "lng": -43.182984,
            "additional_description": "confirm",
            "address_type": "home"
        }
    }
}

Considérations particulières et limites#

Adresse de facturation

Les transactions intérieures acquises par PagBank doivent inclure les renseignements suivants sur les acheteurs dans la demande d'autorisation :

billing_address.zipcode
billing_address.state_name
billing_address.country_code

Cette mesure fait suite à la réglementation locale de retenir la taxe dans la province du client. Lorsque ces données ne sont pas fournies, PagBank retient la taxe en fonction de l'emplacement du commerçant.

Soumettre l'un ou l'autre des codes:

Codes provinciaux locaux (COMARB)

Code de la province COMARB	Code de la province ISO	Nom de la province
901	AR-C	CABA
909	AR-P	Formose
919	AR-D	San Luis
908	AR-E	Entre Ríos
911	AR-L	La Pampa
917	AR-A	Salta
906	AR-H	Chaco
907	AR-U	Chubut
910	AR-Y	Jujuy
920	AR-Z	Sainte-Cruz
903	AR-K	Catamarca
904	AR-X	Cordoue
912	AR-F	La Rioja
922	AR-G	Santiago de l'Estero
918	AR-J	Saint-Jean
913	AR-M	Mendoza
914	AR-N	Missions
915	AR-Q	Neuquén
916	AR-R	Río Negro
923	AR-V	Terre de Feu
902	AR-B	Buenos Aires
921	AR-S	Santa Fé
924	AR-T	Tucumán
905	AR-W	Corrientes

Code de devise : Spécifie le code de devise (ISO 4217) du pays concerné.
Code pays : spécifie le Codes pays ISO
Le nombre de versements est validé par rapport au nombre maximum de versements convenu avec l'acquéreur.
Un paiement qui est AUTHORIZED peut être capturé.
Une capture partielle peut être effectuée si nécessaire.
Chaque paiement autorisé permet une capture partielle ou totale.
Il est recommandé de capturer une commande dans les 5 jours suivant l'autorisation pour éviter son expiration.
Un remboursement ne peut être demandé qu'après qu'un paiement ait atteint le CAPTURED status.
Les remboursements ne peuvent pas dépasser le montant initial capturé, mais un ou plusieurs remboursements partiels du montant capturé peuvent être effectués.
Un seul remboursement partiel peut être effectué par commande.
Un paiement ne peut être annulé (annulé) qu'après avoir atteint le AUTHORIZED status.
L'annulation n'est plus possible une fois le paiement atteint le CAPTURED status.
Une annulation complète (annulée) peut être envoyée par commande.
Ordres avec le recurrence objet présente différenciation entre le premier et les paiements ultérieurs.
1. Le premier paiement est classé par type recurrence.first_time_use = true.
2. Les paiements ultérieurs sont identifiés par type recurrence.first_time_use = false.
3. Remarque: L'ajout du paramètre recurrence.first_time_use n'est pas lié ou conditionné à l'API de paiement récurrent.
Avant de procéder à des paiements en Amérique latine, une personne morale et un acquéreur dans le pays d'opération sont requis.

Ressources d ' essai#

Titres de créance Pagbank

ABAP

Private_Key = 
"44167361-1afc-444a-8c4b-4de444b9387a072451e54f40a400c2e292867b9e2f64a825-39f7-4443-ac02-6d7c42b5104d"

Collection Postman

Demandez à votre équipe d'intégration DEUNA l'environnement actuel de PagBank Postman et la collection.

Cartes de test

Marque	Tapez	Numéro de carte	Mois d'expiration	Année d'expiration	CVV
Visa	Approuvé	4024007197692931	12	2026	123
Maître	Approuvé	5555666677778884	12	2026	123
Visa	Rejeté	4929291898380766	12	2026	123
Maître	Rejeté	5530062640663264	12	2026	123