PagBank | DEUNA Docs

In questa pagina

Integrare Pagbank
Considerazioni e limitazioni speciali
Testare le risorse

Questa pagina fornisce una guida per integrare PagBank con DEUNA.

Operazioni supportate

L'integrazione di PagBank nella vostra strategia di pagamento con DEUNA consente di eseguire le seguenti operazioni:

Autorizzazione
Cattura completa
Acquisizioni parziali
Acquisto (auto-captured)
Rimborso parziale (fino a uno per ordine)
rimborso completo
Void
3DS DEUNA

Metodi di pagamento supportati

Carte:

Visto
Mastercard
Diners
Amex
Elo

Paesi attivi e valute

Brasil (BRL)

Requisiti

Contatta il rappresentante di Pagbank e richiedi le seguenti credenziali:

Le credenziali di PagBank

Assicurarsi che il tuo account sia configurato correttamente sul lato Pagbank.

Integrare Pagbank#

Integrare PagBank in DEUNA

1. Cercare Pagbank in DEUNA

Cercare la connessione PagBank nel tuo amministratore DEUNA e fare clic su di esso.

Esempio interattivoUsa dati di esempio e non effettua richieste API.

Pagamenti

Connessioni

Scopri e gestisci le integrazioni di pagamento, wallet e antifrode.

Acme LATAM · Produzione

Cerca connessioni

Connessioni	Tipo	Stato
Adyen	Gateway di pagamento	Connessa
Worldpay	Gateway di pagamento	Connessa
PayPal	Metodo di pagamento	Connessa
Mercado Pago	Metodo di pagamento	Non connessa
Riskified	Motore antifrode	Non connessa

2. Configurare PagBank nel tuo negozio

Dopo aver cercato Pagbank in Connections, è necessario configurare Pagbank nel tuo negozio.

In Connessioni, una finestra come la seguente si aprirà:

Inserisci le seguenti credenziali:
- In Nome inserire un nome per fare riferimento alle credenziali.
- In Valuta selezionare la valuta del processore di Merchant disponibile.
- In Merchant ID inserire un ID per fare riferimento alle credenziali.
- In Chiave privata entrare nella chiave privata di Pagbank.
Scegli il tipo di operazione che vuoi eseguire:
- Acquisto
- Autorizzazione
Per attivare la connessione tramite API Connect di PagBank, controlla il credenziali Deuna checkbox.
Scegliere se si desidera attivare 3DS.
Cliccare su Collegamento.

3. Autorizzare PagBank tramite API

Se hai scelto di connetterti tramite API Connect di PagBank:

Il portale Deuna ti reindirizzerà al portale Pagbank per completare la connessione.
Inserisci il tuo utente e password di PagBank.

Una volta che il login viene fatto nel tuo account, autorizza il permesso per la connessione.

Una volta completate i passaggi, vedrete un messaggio di successo.

4. Pagamenti di processo in PagBank

Vedrete la connessione Pagbank all'interno della scheda Connessioni attive.

Da questo punto in poi, è ora possibile elaborare le transazioni con Pagbank attraverso DEUNA.

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

Richiesta di ricorrenza

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

Considerazioni e limitazioni speciali#

Indirizzo di fatturazione

Le operazioni nazionali acquistate da PagBank devono includere le seguenti informazioni sull'acquirente nella richiesta di autorizzazione:

billing_address.zipcode
billing_address.state_name
billing_address.country_code

Ciò segue la normativa locale per trattenere l'imposta nella provincia del commerciante. Quando questi dati non vengono forniti, PagBank ritiri l'imposta sulla base della posizione del commerciante.

Inserisci uno dei codici:

Codici provinciali locali (COMARB)

Codice provinciale COMARB	Codice provinciale ISO	Nome della Provincia
901	AR-C	CABA
909	AR-P	Formosa
919	AR-D	San Luis
908	AR-E	Entre Rios
911	AR-L	La Pampa
917	AR-A	Salta
906	AR-H	Chaco
907	AR-U	Chubut
910	AR-Y	Jujuy
920	AR-Z	Santa Cruz
903	AR-K	Catamarca
904	AR-X	Cordova
912	AR-F	La Rioja
922	AR-G	Santiago del Estero
918	AR-J	San Juan
913	AR-M	Mendoza
914	AR-N	Misiones
915	AR-Q	No.
916	AR-R	Rio Negro
923	AR-V	Tierra del Fuego
902	AR-B	Buenos Aires
921	AR-S	Santa Fe
924	AR-T	Tucumán
905	AR-W	Corrientes

Codice valuta: Specifica il codice valuta (ISO 4217) per il paese in questione.
Codice paese: Specifica il Codici di Paese ISO
Il numero di rate viene convalidato rispetto al numero massimo di rate concordate con l'acquirente.
Un pagamento che è AUTHORIZED può essere catturato.
Una cattura parziale può essere eseguita se necessario.
Ogni pagamento autorizzato consente una cattura parziale o completa.
Si raccomanda di catturare un ordine entro 5 giorni dall'autorizzazione per evitare la scadenza.
Un rimborso può essere richiesto solo dopo un pagamento raggiunge il CAPTURED status.
I rimborsi non possono superare l'importo acquisito originale, ma si possono effettuare uno o più rimborsi parziali dell'importo catturato.
Solo un rimborso parziale può essere inviato per ordine.
Un pagamento può essere annullato (Void) solo dopo che raggiunge il AUTHORIZED status.
La cancellazione non è più possibile una volta che il pagamento raggiunge il CAPTURED status.
Cancellazione completa (void) può essere inviata per ordine.
Ordini con il recurrence oggetto di differenziazione presente tra i primi e i successivi pagamenti.
1. Il primo pagamento è classificato per tipo recurrence.first_time_use = true.
2. I pagamenti successivi sono identificati dal tipo recurrence.first_time_use = false.
3. Nota: L'aggiunta del parametro recurrence.first_time_use non è collegato o condizionata all'API di pagamento ricorrenti.
Prima di prendere i pagamenti in America Latina è necessaria una entità giuridica e un acquirente nel paese di funzionamento

Testare le risorse#

credenziali di Pagbank

ABAP

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

Raccolta Postman

Richiedi l'attuale ambiente e la raccolta di PagBank Postman dal tuo team di integrazione DEUNA.

Testare le carte

Marca	Tipo	Numero della carta	Mese di scadenza	Anno di scadenza	CVV
Visto	Approvazione	4024007197692931	12	2026	123
Maestro	Approvazione	5555666677778884	12	2026	123
Visto	Rifiutata	4929291898380766	12	2026	123
Maestro	Rifiutata	5530062640663264	12	2026	123