HTTP Codes

HTTP Status CodeDescription
200OK (Capture/Void/Get)
201OK (Authorization)
400Bad Request
401Unauthorized
403Forbidden
404Resource Not Found
405Method Not Allowed
500Internal Server Error
502Bad Gateway
503Service Unavailable
400Bad Request
404Resource Not Found
500Internal Server Error

See some example scenarios for when each HTTP code may return:

Successful responses

Returned HTTPExample
200 OkThe request succeeded. E.g.: when creating an AccessToken, when performing a capture, void or GET.
201 CreatedThe request succeeded and the transaction was created (for all payment methods: boleto, credit, debit, electronic transfer and e-wallet).

Client error responses

Retorno HTTPExample
400 Bad RequestThe request is not valid. E.g: error in JSON request syntax.
401 UnauthorizedAuthentication error. E.g.: wrong MerchantKey.
403 ForbiddenNon-authorized due to IP restriction in the e-commerce.
404 Not FoundThe server can not find the requested resource. E.g.: wrong endpoint; for order search: the order does not exist, or was created by another merchant or the order is older than three months.
405 Method Not AllowedWrong HTTP method (POST, PUT, GET, PATCH, DELETE).

Server error responses

Returned HTTPExample
500 Internal Server Error, 502 Bad Gateway or 503 Service UnavailableThese error responses can return due to some internal fail, such as unavailable payment method or low speed. If you get any of these responses, we recommend contacting our Support for further information.