Status codes

Transaction Operation Status Codes

Payment status codes indicate the status of a payment transaction processed through MoneyHash payment API. We offer a unified status code list that maps and connects to the original codes sent by the payment provider. MoneyHash ensures the raw original error code data sent by the provider is always available upon request.

You can retrieve the payment status codes in the transaction webhooks sent by MoneyHash API. Within the transaction status object, you will find a nested statuses array that includes detailed information about the transaction status.

{
  "transaction": {
    "type": "payment",
    "id": "c19ffb2f-7b52-4a71-a784-f433e0133d91",
    "created": "2023-07-09 11:19:20.129043+00:00",
    "status": "purchase.successful",
    "billing_data": null,
    "external_action_message": [],
    "provider_transaction_fields": {},
    "operations": [
      {
        "id": "g6PaPD9",
        "type": "purchase",
        "status": "successful",
        "amount": {
          "value": 50,
          "currency": "USD"
        },
        "statuses": [
          {
            "id": "9z0y4qg",
            "value": "successful",
            "code": "6000",
            "message": "Successful",
            "created": "2023-07-09 11:19:20.233369+00:00"
          }
        ],
        "refund_type": null
      }
    ]
  }
}
        

Payment Status Codes

MoneyHash defines multiple code ranges to help you identify the status of each operation, and we group status codes as the following:

Additionally, we use specific status codes to provide more detailed information about the payment status. When a specific status is available, we replace the trailing zeros (000) in the general status code with a different number referring to the detailed status. Here’s a list of possible statuses:

Handling Response Codes

When integrating our online payment API, it is important to handle payment status code. This involves checking the response code and taking appropriate actions or error handling based on the specific scenario.