- 19 Feb 2025
- 1 Minute to read
- Print
- DarkLight
PIX
- Updated on 19 Feb 2025
- 1 Minute to read
- Print
- DarkLight
PIX is a widely popular payment method in Brazil, known for its convenience and speed. Developed by the Central Bank of Brazil, it allows instant, 24/7 money transfers using simple identifiers like phone numbers, email addresses, or unique PIX keys. Since its launch, PIX has become essential for everyday transactions, from person-to-person transfers to payments for goods and services, making it a preferred choice across the country.
Supported Transaction Types
Authorisation
Purchase
Capture
Void
Refunds
Withdrawals
Integrations Supported
Direct Connect
Withdrawal
Hosted Payment Page
Direct Connect ( server-to-server)
Currencies & Countries Supported
Title | Description |
---|---|
Currencies Supported | BRL |
Countries Supported | Brazil |
Additional attributes to process Cards via Monetix
You must include the following JSON Attributes to the payload. These attributes inform us to proceed with the redirection to finalise the payment process.
Description | Hosted Payment Page | Direct Connect (Withdrawals only) |
---|---|---|
Transaction type | "TransactionType": "PURC", | "TransactionType": "ORIGINALCREDIT", |
Force Transaction Routing | “Routing”:{ "ForcePayment": "MONETIX” } | “Routing”:{ "ForcePayment": "MONETIX” } |
Client Details | "Client": { "FirstName": "Joe", "LastName": "Borg", "Street": "12 Church street", "City": "Valletta", "Email": "TestEmail@Email.com", "ClientAccount": "testing", "IPAddress":"1.1.1.1" "DateOfBirth":"2000-10-10" } | Client": { "FirstName": "Joe", "LastName": "Borg", "Street": "12 Church street", "City": "Valletta", "Email": "TestEmail@Email.com", "ClientAccount": "testing", "IPAddress":"1.1.1.1" "DateOfBirth":"2000-10-10" } |
Payment Method Data | "PaymentMethodData": { "PaymentMethod": "PIX" "DocumentNumber":"91175478067", "RecipientPixKey":"91175478067" }, | "PaymentDestination": { "PaymentMethod": "AlternativePaymentMethods", "PaymentMethodData": { "PaymentMethod": "PIX", "DocumentNumber":"91175478067", "RecipientPixKey":"91175478067", "BeneficiaryAccountNumber":"233123456789" } }, |
Test Indicator (required in Sandbox Environment only) | "isTest”: true | "isTest”: true |
Sample request for Deposit
{
"TransactionType": "PURC",
"Amount": 100.00,
"Currency": "BRL",
"OrderReference": "Monetix PIX test",
"UniqueReference": "3a9f50f7-2deb-4dbf-a186-d58641s36665",
"RedirectionURL": "https://www.yourURLhere.com/Redirect/",
"CallBackURL": "https://www.yourURLhere.com/Listener",
"Routing": {
"ForcePayment": "MONETIX"
},
"IsTest": true,
"Client": {
"FirstName": "Joe",
"LastName": "Borg",
"City": "TestCity",
"Street": "fakestreet 123",
"Email": "TestEmail@Email.com",
"ClientAccount": "testing",
"IPAddress": "1.1.1.1",
"MobileNo":"123456",
"DateOfBirth":"2000-10-10"
},
"PaymentMethodData": {
"PaymentMethod": "PIX",
"DocumentNumber":"91175478067",
"RecipientPixKey":"91175478067"
}
}
Sample request for a Payout
{
"TransactionType": "ORIGINALCREDIT",
"Amount": "100.00",
"Currency": "BRL",
"OrderReference": "Monetix payout test",
"UniqueReference": "3a9f50f7-2deb-4dbf-a186-d58651s36665",
"IsTest": true,
"RedirectionURL": "https://www.yourURLhere.com/Redirect",
"CallBackURL": "https://www.yourURLhere.com/Listener",
"Routing": {
"ForcePayment": "MONETIX"
}
"Client": {
"FirstName": "Joe",
"LastName": "Borg",
"City": "TestCity",
"Email": "TestEmail@Email.com",
"Street": "fakestreet 123",
"ClientAccount": "testing",
"IPAddress": "1.1.1.1",
"MobileNo":"123456",
"DateOfBirth":"2000-10-10"
},
"PaymentDestination": {
"PaymentMethod": "AlternativePaymentMethods",
"PaymentMethodData": {
"PaymentMethod": "PIX",
"DocumentNumber":"91175478067",
"RecipientPixKey":"91175478067",
"BeneficiaryAccountNumber":"233123456789"
}
}
}