PayPaga
  1. Pay In - Brazil
PayPaga
  • Introduction
    • Introduction
    • API Reference
    • Errors
    • Standard Codes and Values
  • Authorization
    • Authorization
    • OAuth 2.0 Token Generation
  • Pay In - Direct API Integration
    • Pay In - Direct API Integration
    • Pay In - Payment Options
    • Pay In - Payment Processing
    • Pay In - Query Transactions
  • Pay In - PayURL Integration
    • Pay In - PayURL Integration
    • Pay In - Create PayURL
  • Pay In - Examples
    • Pay In - Argentina
      • Pay In - CVU
    • Pay In - Brazil
      • Pay In - PIX
        POST
    • Pay In - Chile
      • Pay In - Bank Transfer
    • Pay In - Colombia
      • Pay In - Dale
      • Pay In - Daviplata
      • Pay In - Efecty
      • Pay In - Gana
      • Pay In - Movii
      • Pay In - Nequi
      • Pay In - PSE
      • Pay In - Puntored
      • Pay In - RappiPay
      • Pay In - ReFacil
      • Pay In - Susuerte
      • Pay In - Western Union
    • Pay In - Ecuador
      • Pay In - Bemóvil
      • Pay In - Deuna
      • Pay In - Mi Negocio Efectivo
      • Pay In - Omniswitch
      • Pay In - Banco Pichincha
      • Pay In - Rapi Activo
      • Pay In - Western Union
    • Pay In - El Salvador
      • Pay In - Banco Agrícola
      • Pay In - Banco Cuscatlán
      • Pay In - Puntoxpress
    • Pay In - Guatemala
      • Pay In - BAM Efectivo
      • Pay In - BAM Transferencia
      • Pay In - Banco Industrial
      • Pay In - Akisi Pronet
    • Pay In - Mexico
      • Pay In - Pay With Cash
      • Pay In - Bank Transfer
    • Pay In - Peru
      • Pay In - BBVA
      • Pay In - BCP
      • Pay In - BCP Efectivo
      • Pay In - Cell Power
      • Pay In - KasNet
      • Pay In - QR Interoperable
      • Pay In - Plin
      • Pay In - Yape
  • Pay Out - Direct API Integration
    • Pay Out - Direct API Integration
    • Pay Out - Query Transactions
    • Pay Out - Payment Processing
  • Pay Out - Examples
    • Pay Out - Brazil
    • Pay Out - Mexico
    • Pay Out - Argentina (V2)
    • Pay Out - Colombia (V2)
    • Pay Out - Ecuador (V2)
    • Pay Out - Guatemala (V2)
    • Pay Out - Peru (V2)
    • Pay Out - Chile (V2)
  • Transactions Status Notification
    • Transactions Status Notification
  • Query Balance
    • Query Balance
  • Appendix
    • Transaction Status Definitions and Lifecycle
  1. Pay In - Brazil

Pay In - PIX

Developing
Develop Env
https://api.v2.stg.paypaga.com
Develop Env
https://api.v2.stg.paypaga.com
POST
https://api.v2.stg.paypaga.com
/payment

Fields validation#

fieldvalidation
first_namerequired, min length 2, max length 50, regexp ^\p{L}*(?:[ '-]\p{L}+)*$
last_namerequired, min length 2, max length 50, regexp ^\p{L}*(?:[ '-]\p{L}+)*$
cpf_numberrequired, regexp ^(\d{3}\.?\d{3}\.?\d{3}-?\d{2}|\d{11})$, must be valid Brazilian CPF

Request

Header Params

Body Params application/json

Examples

Responses

🟢200Success
application/json
Body

🟠400Bad Request
🔴500Server Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.v2.stg.paypaga.com/payment' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
  "transaction_id": "20251029-1517-41fc-ae26-f66a768bab2b",
  "transaction_total": 100.03,
  "payment_method_code": "BNKTR",
  "currency": "BRL",
  "merchant_transaction_reference": "abc4561698162696828",
  "transaction_fields": [
    {
      "name": "first_name",
      "value": "Barão"
    },
    {
      "name": "last_name",
      "value": "Praça"
    },
    {
      "name": "cpf_number",
      "value": "241.390.720-32"
    }
  ]
}'
Response Response Example
200 - Success
{
  "transaction_id": "20251029-1517-41fc-ae26-f66a768bab2b",
  "transaction_payment_mode": "ASYNCHRONOUS",
  "payment_method_reference": "129930",
  "message": "Transaction Successfully",
  "version": "0.1",
  "next_steps_detail_instructions": [
    {
      "type": "label",
      "key": "payment_method",
      "label": "Payment Method",
      "description": "pix"
    },
    {
      "type": "label",
      "key": "main_instructions",
      "label": "Instruções",
      "description": "Escaneie o código QR ou copie o PIX Copia-Cola para prosseguir com o pagamento. Você tem 4 dias para poder completar seu pagamento."
    },
    {
      "type": "qr_link",
      "key": "qr_content",
      "label": "QR",
      "description": "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"
    },
    {
      "type": "copy_link",
      "key": "text_sequence",
      "label": "Copia Cola",
      "description": "00020101021226880014br.gov.bcb.pix2566qrcode-h.fitbank.com.br/QR/cob/9BA5CDA69AB1CBAA0EE61D1F2910AB030FD5204000053039865802BR5925ORKESTRA TECNOLOGIA EM PA6014Belo Horizonte61083031002062070503***63043A5B"
    }
  ]
}
Previous
Pay In - CVU
Next
Pay In - Bank Transfer
Built with