Pay In - Payment Processing
Developing
Develop Env
https://merchant-api.stg.paypaga.com
Develop Env
https://merchant-api.stg.paypaga.com
POST
https://merchant-api.stg.paypaga.com
| Country | Payment Method | Field |
|---|---|---|
| BR | BNKTR | First name |
| BR | BNKTR | Last name |
| BR | BNKTR | CPF - Cadastro de Pessoas Físicas (11 digits unformatted) |
| Error code | Description |
|---|---|
| 100 | Input validations error(s) |
| 101 | The transaction is already processed |
| 102 | The transaction has failed previously |
| 105 | The transaction total amount doesn't match with the transaction total amount previously sent in the payment options endpoint (applies only when total amount > 0) |
| 106 | Payment processing failed, please contact our IT support team |
| 109 | Required Transaction Fields are missing |
| 111 | transaction_total must be greater than 0 and less than 10000000.00 |
| 112 | Selected Payment Method Not Found |
| 113 | Transaction Configuration Not Found |
| 114 | Transaction Rejected Due To Payment Method Limits |
| 123 | Merchant id mismatch |
| 151 | Country or currency is invalid |
| 195 | Bad Request |
| 196 | Error To Connect to the Partner |
| 500 | Unexpected error |
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://merchant-api.stg.paypaga.com/payment' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
"transaction_id": "20240201-0028-5510-a83b-82042d2bc79d",
"merchant_id": "4392a925-8eb1-4ba5-bbd4-e6085c15758d",
"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": "12234514789"
}
]
}'Response Response Example
200 - Success
{
"transaction_id": "20240202-1733-0118-90ca-7b779a307568",
"transaction_payment_mode": "ASYNCHRONOUS",
"payment_method_reference": "1441258800171",
"message": "Transaction Successfully",
"next_steps_detail_instructions": [
{
"type": "label",
"key": "main_instructions",
"label": "Instructions",
"description": "Keep the reference number, after locating a near agency ask the cashier by telling you want to pay a Paycash reference and share the reference number. Make sure you get a ticket to confirm the payment"
},
{
"key": "reference_url",
"label": "Click here for a payment details page.",
"description": "http://ec2-3-140-103-165.us-east-2.compute.amazonaws.com:8085/formato.php?referencia=MTQ0MTI1ODgwMDE3MQ==&interno=1"
}
]
}Request
Header Params
Body Params application/json