FAQ
Frequently asked questions about testing environment, checkout minimum amount, payment confirmation, settlement, and API responses.
Frequently asked questions#
Use this page as a quick guide for validating basic settings before going into the endpoint reference.
When the API returns an error, check the message field in the response body. It should include the readable reason for the failure. For the checkout reference, open Checkout.
EnvironmentWhere do integration tests happen?
Integration tests run in Triad Pay production, using the real credentials for the company.
For cash-in and cash-out flows, unless there is a contractual exception, the CPF or CNPJ on the customer must be valid and belong to the same owner making the transfer. Ownership mismatches can reject test transactions.
LimitsWhat is the minimum amount for a generated checkout?
Each generated checkout must have a minimum amount of R$ 10.00. Amounts below this limit should not be sent when creating a checkout.
CheckoutminimumR$ 10.00 per generated checkout.
ConfirmationHow do I know the payment was confirmed?
Payment confirmation should be based on checkout status. Your system can track the charge through polling, receive updates by webhook, or query the status before releasing the order.
Returning the buyer to the store improves the user experience, but should not be used by itself as financial confirmation. Release the order only after the checkout is confirmed as paid.
SettlementHow do I receive the money after payment?
After payment confirmation and settlement, the amount becomes available in your dashboard. From there, you can request a withdrawal or use the balance to make payments.
ErrorsWhich HTTP status codes does the API return?
The API uses conventional HTTP codes for success, validation, authentication, authorization, and internal failures.
200 OKsuccessThe request was processed successfully.
201 CreatedsuccessA new resource was created on the server.
400 Bad RequesterrorThe payload is invalid or incomplete.
401 UnauthorizederrorThe Bearer token is missing or invalid.
403 ForbiddenerrorThe token is valid, but cannot perform this action.
404 Not FounderrorThe requested resource was not found.
409 ConflicterrorThe action conflicts with the current resource state.
500 Internal Server ErrorerrorInternal server failure.