Overview

The PagSeguro International Payin API allows you to accept payments from customers around the globe using international cards, digital wallets, and local methods in key markets.

This API is designed for flexibility and reach, supporting multiple payment types, currencies, and local compliance needs, helping you grow your global customer base with confidence.

Why Use the Payin API?

PagSeguro’s International Payin API enables:

• Global coverage: Accept payments from international cards and wallets across supported countries.
• Multicurrency support: Handle payments in your customer’s local currency.
• Built-in compliance and fraud tools: Minimize risk with fraud prevention tools and PCI-aligned tokenization.
• Flexible integrations: Choose between raw data, secure tokens, or wallet flows like Google Pay.
• Installment support: Offer credit card installment payments, especially common in Latin America, allowing customers to pay over time while you receive funds upfront.

How It Works

Every transaction follows a secure, multi-step server-side flow:

1. Your customer initiates a payment on your app or website.
2. You send payment and order details to PagSeguro using the Payin API.
3. PagSeguro processes the transaction and returns the result.
4. You receive updates through webhooks or status queries.

Supporting Reference Pages

To help you implement the International Payin API correctly, you can check the reference pages. These supporting resources provide information on validation rules, supported configurations, and status handling across different countries:

• Document Validation: Understand the document types and formats required to identify payers.
• Maximum and Minimum Supported Amounts: View transaction limits per country to ensure your payments fall within allowed thresholds.
• Supported Countries: See the full list of countries where the International Payin API can be used.
• Supported Currencies: Check which currencies are available.
• Payment Methods: Check the available payment methods enums you can use when creating a payment with PagSeguro.
• Transaction Status Description: Learn about the possible transaction and refund statuses.
• Reason Codes: Understand the detailed reason codes returned in transaction responses.

Available Guides

Each guide walks you through the details of integrating specific payment types and managing the transaction lifecycle.

• Create a Credit Card Transaction Start accepting payments using raw credit card data or tokenized cards.
• Create a Transaction with Installments: Learn how to offer split payments to customers using interest-free installment plans.
• Create a Transaction Using 3DS: Use 3D Secure (3DS) authentication data obtained from an external MPI provider to create a transaction.
• Create a Google Pay™ Transaction: Accept payments using Google Pay™ with secure token exchange.
• Check a Transaction Status: Learn how to monitor and confirm transaction status in real time.
• Request a Refund: Issue partial or full refunds for completed transactions.
• Search for Transactions by Period: Retrieve lists of transactions using date filters.

Test the International Payin API

Use PagSeguro’s Sandbox Environment to simulate real-world flows without processing actual payments. You can even generate test statuses using our transaction simulation panel.