PagBank | DEUNA Docs

En esta página

Integrar Pagbank
Consideraciones y limitaciones especiales
Recursos de prueba

Esta página proporciona una guía para integrar PagBank con DEUNA.

Operaciones soportadas

La integración de PagBank en tu estrategia de pagos con DEUNA te permite realizar las siguientes operaciones:

Autorización
captura completa
Capturas parciales
Compra (captura automática)
Reembolso parcial (hasta uno por pedido)
Reembolso completo
Anulación
3DS DEUNA

Métodos de pago admitidos

Tarjetas:

visa
Mastercard
Comensales
Amex
elo

Países y monedas activos

Brasil (BRL)

Requisitos

Contacta con tu representante de Pagbank y solicita las siguientes credenciales:

Tus credenciales de PagBank

Asegúrese de que su cuenta esté configurada correctamente en el lado de Pagbank.

Integrar Pagbank#

Integrar PagBank en DEUNA

1. Busca Pagbank en DEUNA

Busque la conexión PagBank en su Administrador DEUNA y haga clic en ella.

Ejemplo interactivoUsa datos de ejemplo y no realiza solicitudes de API.

Pagos

Conexiones

Descubre y administra integraciones de pago, billeteras y antifraude.

Acme LATAM · Producción

Buscar conexiones

Conexiones	Tipo	Estado
Adyen	Pasarela de pago	Conectada
Worldpay	Pasarela de pago	Conectada
PayPal	Método de pago	Conectada
Mercado Pago	Método de pago	Sin conectar
Riskified	Motor antifraude	Sin conectar

2. Configura PagBank en tu tienda

Después de buscar Pagbank en Connections, debes configurar Pagbank en tu tienda.

En Conexiones se abrirá una ventana como la siguiente:

Ingrese las siguientes credenciales:
- En Nombre introduzca un nombre para hacer referencia a la credencial.
- En Moneda seleccione la moneda del procesador comercial disponible.
- En Merchant ID introduzca un ID para hacer referencia a la credencial.
- En Clave Privada ingrese la clave privada de Pagbank.
Elija el tipo de operación que desea realizar:
- Compra
- Autorización
Para activar su conexión a través de API Connect de PagBank, consulte la credenciales deuna checkbox.
Elige si quieres activar 3DS.
Clic Conectar.

3. Autorizar PagBank vía API

Si elige conectarse a través de API Connect de PagBank:

El portal de Deuna te redireccionará al portal de Pagbank para completar la conexión.
Introduce tu usuario y contraseña de PagBank.

Una vez que haya iniciado sesión en su cuenta, autorice el permiso para la conexión.

Una vez que complete los pasos, verá un mensaje de éxito.

4. Procesar pagos en PagBank

Verás la conexión de Pagbank dentro de la pestaña Conexiones activas.

A partir de este momento ya podrás procesar transacciones con Pagbank a través de DEUNA.

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

Solicitud con recurrencia

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

Consideraciones y limitaciones especiales#

dirección de facturación

Las transacciones nacionales adquiridas por PagBank deben incluir la siguiente información del comprador en la solicitud de autorización:

billing_address.zipcode
billing_address.state_name
billing_address.country_code

Esto sigue la regulación local para retener impuestos en la provincia del comprador. Cuando no se proporcionan estos datos, PagBank retiene impuestos según la ubicación del comerciante.

Envíe cualquiera de los códigos:

Códigos de provincia locales (COMARB)

Código de provincia COMARB	Código de provincia ISO	Nombre de la provincia
901	AR-C	CABA
909	AR-P	Formosa
919	AR-D	sanluis
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	santa cruz
903	AR-K	Catamarca
904	AR-X	Córdoba
912	AR-F	Rioja
922	AR-G	santiago del estero
918	AR-J	san juan
913	AR-M	Mendoza
914	AR-N	Misiones
915	AR-Q	Neuquén
916	AR-R	Río Negro
923	AR-V	Tierra del Fuego
902	AR-B	buenos aires
921	AR-S	Santa Fé
924	AR-T	Tucumán
905	AR-W	Corrientes

Código de moneda: especifica el código de moneda (ISO 4217) para el país correspondiente.
Código de país: especifica el Códigos ISO de países
El número de cuotas se valida contra el número máximo de cuotas acordado con el adquirente.
Un pago que es AUTHORIZED puede ser capturado.
Se puede realizar una captura parcial si es necesario.
Cada pago autorizado permite una captura parcial o total.
Se recomienda capturar un pedido dentro de los 5 días posteriores a la autorización para evitar su vencimiento.
Se puede solicitar un reembolso sólo después de que el pago llegue al CAPTURED status.
Los reembolsos no pueden exceder el monto capturado original, pero se pueden realizar uno o más reembolsos parciales del monto capturado.
Solo se puede enviar un reembolso parcial por pedido.
Un pago puede cancelarse (anularse) sólo después de que alcance el AUTHORIZED status.
La cancelación ya no es posible una vez que el pago llega al CAPTURED status.
Se puede enviar una cancelación completa (anulación) por pedido.
pedidos con el recurrence objeto presentar diferenciación entre el primer pago y los siguientes.
1. El primer pago se clasifica por tipo. recurrence.first_time_use = true.
2. Los pagos posteriores se identifican por el tipo recurrence.first_time_use = false.
3. Nota: La adición del parámetro recurrence.first_time_use no está vinculado ni condicionado a la API de Pago Recurrente.
Antes de realizar pagos en América Latina se requiere una entidad legal y un adquirente en el país de operación.

Recursos de prueba#

Credenciales de Pagbank

ABAP

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

Colección de Postman

Solicita el entorno y cobro actual de PagBank Postman a tu equipo de integración de DEUNA.

Tarjetas de prueba

Marca	Tipo	Número de tarjeta	Mes de vencimiento	Año de vencimiento	CVV
visa	Aprobado	4024007197692931	12	2026	123
maestro	Aprobado	5555666677778884	12	2026	123
visa	Rechazado	4929291898380766	12	2026	123
maestro	Rechazado	5530062640663264	12	2026	123