HTTP Status Code

HTTP CodeHTTP StatusDescription
200OKEverything is working as expected
400Bad RequestThe request is not accepted due to missing parameter or wrong parameter format
401UnauthorizedNo valid API key provided
403ForbiddenThe API key does not have permission to perform the request
404Not FoundThe requested resource is not valid
405Method Not AllowedThe request method is not supported for the requested resource
409ConflictThe request conflicted with another request (possibly due to having the same idempotency key)
429Too Many RequestsToo many requests hit the API too quickly. We recommend limiting the request amount or implementing exponential backoff
5xxServer ErrorsSomething went wrong on Midtrans' end. To handle this:
  1. Reach out to our support team for clarification on whether it's safe to retry the request. Explain the issue you encountered.

  2. Ensure you include all relevant request details. This could involve the specific API endpoint, payload, and any relevant parameters used.

  3. If your request used an idempotency key, make sure to provide it. The idempotency key helps ensure that the same request is not processed multiple times if retried.By following these steps, you can get the necessary guidance on whether retrying is safe and how to proceed.