Error Codes

When there is an error, Fiat Republic returns an object with an error code and a high level description of the error.

Where relevant, the object will further contain a list of 1 or more warnings containing the position (name of the field that has the error) and the issue describing the error and possible steps to fix it.

{
    "errorCode": "ERROR_CODE",
    "message": "High level message describing the error",
    "warnings": [
        {
            "position": "fieldNameContainingError",
            "issue": "description of the error"
        },
        {
            "position": "fieldNameContainingError",
            "issue": "description of the error"
        }
    ]
}

Examples of error messages

{  
    "errorCode": "INVALID_REQUEST_DATA",  
    "message": "Invalid FiatAccountRequest",  
    "warnings": [  
        {  
            "position": "currency",  
            "issue": "Field is required"  
        }  
    ]  
}

{  
    "errorCode": "INVALID_REQUEST_DATA",  
    "message": "Payments can be made only to Payees with ACTIVE status"  
}

{  
    "errorCode": "RESOURCE_MISSING",  
    "message": "FiatAccount with 'fac_d8ovyep1r9b1kx65n2' id does not exist."  
}

{
    "errorCode": "INVALID_REQUEST_DATA",
    "message": "Invalid Payment input.",
    "warnings": [
        {
            "position": "paymentScheme",
            "issue": "possible values: [FPS, CHAPS]"
        }
    ]
}