PIX PayIn

Payment registration transactions

PIX HPP & H2H


1. PIX PayIn

Description:
Pix is a real-time payment system in Brazil. Developed by the Brazilian Central Bank, it allows users to make instant payments with immediate confirmation, available 24/7.
 
Allows the creation of pay-ins (incoming payments).
 
URL:https://api.payelu.xyz/api/v1/payments/payin_hth
 

Country Uses:

  • Brazil: PIX
 

Request Parameters:

Parameter
Type
Description
Requeriment
service_code
string
PIX_BR
required
amount
num
Amount to process. e.g. 123.45
required
reference
string
Merchant’s Unique ID for transaction. It must be 22 alfanumeric digits (i.e. ‘0000000000002507135224‘)
required
expired_at
string
Payment expiration datetime in UTC (ISO 8601 format). It must be between 1 hour and 23 hours from creation.
required

PIX Example Request:

{ "service_code": "PIX_BR", "amount": 200, "reference": "0000000000002507135224", "expired_at": "2025-06-06T22:59:59Z", }

PIX Example Response:

{ "status": "success", "data": { "transaction_id": "8684db6b-5401-45be-b023-c19f83f3248d", "amount": 568.0, "currency": "BRL", "status": "PENDING", "reference": "0000200006032533644352", "created_at": "2025-06-02T19:00:04.930517Z", "updated_at": "2025-06-02T19:00:04.930524Z", "expired_at": "2025-06-05T19:00:04.028194Z", "qrCode": "iVBORw0KGgoAAAANSUhEUgAAAeoAAAHqAQAAAADjFjCXAAAEjklEQVR4nO2dTY7jOAyFH8cBZukAfYA6inODOdJgbuYcpW/gLBuwwVlI/FF1rewaaIQ8LlJO4g+xAEISyUcVUG1SVd2BZatXus6qWOxKVVWBWRXLZhD+wCUj/p44sKiq6jYpFlUFAOiKSevXxeF2mE/CHVO198MTHxTPjrT6W2DSMtfFLZjD9SYFMNHriJ8197qyfBaHQ53wylXMdcX16HXEvwvXFYeo6i+x7dsh8gAgIjfIA+5r/8WvE38jvNnXbfZ2xaR1+7YBNZTY4jPu64hfw58iInIHUCay1w3y91a/lgcmlcfrBnkgPjtERET6PzzxIXGbyFRL+KDrvKPEFSWbsjX31WyKE0OPnXgvvNqnjMjiCy4ApCW1rL/zjvoy9NiJ98bnHQAOkcdLRP/5+CU1kPX0yfN+CJ53AHj9WT6Tx//j4YkPhiNHCSVBohZDbJ4+KfkSlFgDS/niG36d+HviNVW36I7ygtlKEJh3n+smjSxx3evNjGGJn7ZUB5ur69WN3AZPpFiVLCoXJVU89NiJ98LNm8z1LEFc11WzUASYT64Aowni5+wm5e/rx64AIHgJfJlVAQAFjnKbLD9vkBJ6zBtk7LET74UXizks5rq6c5tbRYq/ZR2W+HkrUaong5PXpaTdHAni3QNZeh3xCxaqJiu8RpWi7OZgsQbg6rt5v/7rxN8TT3lgkzY10roIJIrSyQLZesvQYyfeCzeLyW0Dkm69znBNvm4tBOc64ufN/OrTXBfJYCtVWAzhEqjeD098UNysneZSRs5uMC1xVd/V/d/QYyfeC4fp1uG1sexXKJObr6u1ZcKvhh478V54ruqnz0w8HC9WpVUvZNDriJ/Gn/eqIK55ONUqHpY7IA8AeH54+gRAuZnRBPHz1rTCNk1hsX2LCS/NdTO1xMTPWtEIA8j7Oo8mgOR6QN4EKuc64qfNpXWmTI+ksS2pi7X9J+Ens8TEz1teQzXrNusK6xUx1xxbk8U3/Drx98SRY9MNaA4AsOpX6Dur2SkA3NcRP2Wp47osmrMfLOFLr1oOz0qwXiUbeuzEe+FpX4cv1CdpNf1yThx67MR74Z4gaVp2UnuEhRlVXxzHiSm9jvhZi61aVtCFjHP7rQs7t2IPPXbivXBEK6Ip6MzrUpYE3kG2AagHO3FfR/yspWlu+fKEWIswQgLgYrzeD098UBxIxySG0m7e/ZjY1gm3StSod+ixE++Fm5ZuDkFJ6OvimMTfesTYD0v8gtXIAWiWT3iB1jwRSRuw+bdDj514L9zKXbali5OHk6C97aXIRduhx068Fw7EqSVReAjJcDELHyLMZZaY+AWL4uqnI07iiJ3QARSrSTvOdcSv2uQJkogXPh2J3bb9M19H/LyFm6nt6+CrrhVjrWUnChTUEhO/YPFfTpJztVpiL1Wkrh72iBG/YPl/6zSHc9aDYKdGsh5lMc51xM/aLb8pp1wfNwCH4PmhkEUBLCsAvH6UXjIFFHj+ddx6PzzxQfG0rwMQzTtTkpbYfdb778c+9X544oPibpMFCFFubWv+fnSdhRSs/hM/af8Cz6VUaMQ2Ap4AAAAASUVORK5CYII=" "brCode": "XXXXXXX", "redirect_hpp_url": "XXXXXXX" }
After receiving redirect_hpp_url, you need to redirect the client to the URL and wait for the final status of the transaction.