List supported countries

Production

https://api.paypaga.com

GET

/v2/catalog/countries

Can be used to retrieve the list of countries supported by the merchant along with their default and additional currencies and available payment methods.

Error codes for List Supported Countries

HTTP status	Error code	Description
400	VALIDATION_ERROR	Request validation failed
401	UNAUTHORIZED	Missing or invalid authorization token
403	FORBIDDEN	You do not have permission to access this resource
500	INTERNAL_ERROR	Unexpected server error

Request

Authorization

OAuth 2.0

Client Credentials

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Token URL: https://api.paypaga.com/oauth2/token

Query Params

Responses

🟢200

application/json

Supported country catalog.

Bodyapplication/json

🟠400ValidationError

🟠401Unauthorized

🟠403Forbidden

🔴500InternalError

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.paypaga.com/v2/catalog/countries?country=undefined&payment_method=undefined&currency=undefined'

Response Example

200 - Example 1

{
    "items": [
        {
            "country": "BR",
            "currency": "BRL",
            "payment_methods": [
                "pix",
                "cvu"
            ]
        }
    ]
}

Modified at 2026-06-09 15:16:31

Retrieve merchant balance summary.

List supported payment methods

List supported countries

Error codes for List Supported Countries#

Request

Responses

Error codes for List Supported Countries