Skip to content

Errors

Error Examples

Error Description Parameters/Request Body Response Body
400 transfer-to/combo/card/register referenceExists Error REQUEST BODY
{
  "reference": "externalCardId101",
  "card": {
    "encryptedData":
"Snbx7y1UUwOjJ44jUA0OjHWz184mpK5dqaHGGHzQML7_
d6FolgQ25VEq4UusvmSSMCziNF8h7wq2GjzJXMO3Yghuu
YqIw_2VvObd0TevFnjfFGL30qMM8GY2Q6BzRuXRdHMuy6
qT4SPypJnDXbleHeEvjtzGSZ5zLlYp9BboyKU0oFGmT0P
-_j4TQ2AHSnOF17bM5AZGkdKBzNBTLREKbMKev5ZF6ot1
oAoeau9EldgOs74vBiKhGoUKSIbJl5E9cOXUmWCrUribl
StRQkA-JSUEhkuZnReOEM83VEeVvaHYVtcxXydpIo55ec
Pg6EOTMlO41UDu3dExos0ssOVSUg",
    "keyId": "je87i6-C2QJS7PHUAbJPqw"
  },
  "owner": {
    "name": {
      "first": "John",
      "middle": "M",
      "last": "Doe",
      "suffix": "III"
    },
    "address": {
      "addressLine1": "1346 Pleasant Ave",
      "addressLine2": "Apt A123",
      "city": "Salt Lake City",
      "state": "UT",
      "postalCode": "12345",
      "country": "US"
    },
    "phone": {
      "countryCode": "1",
      "number": "5556667777"
    }
  }
}		 RESPONSE BODY
{
    "requestId":
"1914024081a611ee9b7427220cc6c212",
    "code": "referenceExists",
    "context": {
        "reference": "externalCardId101",
        "entityId": "tcrd_GK002yheLpK1VjsAFIumm"
    },
    "message": "Reference already exists."
}
400 transfer-to/combo/card/register requestValidateError - Missing required property REQUEST BODY
{
  "reference": "externalCardId102",
  "owner": {
    "name": {
      "first": "John",
      "middle": "M",
      "last": "Doe",
      "suffix": "III"
    },
    "address": {
      "addressLine1": "1346 Pleasant Ave",
      "addressLine2": "Apt A123",
      "city": "Salt Lake City",
      "state": "UT",
      "postalCode": "12345",
      "country": "US"
    },
    "phone": {
      "countryCode": "1",
      "number": "5556667777"
    }
  }
}		 RESPONSE BODY
{
    "requestId":
"2dbf73a081a611ee9b7427220cc6c212",
    "code": "requestValidateError",
    "context": [
        {
            "instancePath": "",
            "schemaPath": "#/required",
            "keyword": "required",
            "params": {
                "missingProperty": "card"
            },
            "message": "must have required property 'card'"
        }
    ]
}
400 transfer-to/combo/card/register extToucan Error Invalid keyId REQUEST BODY
{
  "reference": "externalCardId103",
  "card": {
    "encryptedData":
"Snbx7y1UUwOjJ44jUA0OjHWz184mpK5dqaHGGHzQML7_
d6FolgQ25VEq4UusvmSSMCziNF8h7wq2GjzJXMO3Yghuu
YqIw_2VvObd0TevFnjfFGL30qMM8GY2Q6BzRuXRdHMuy6
qT4SPypJnDXbleHeEvjtzGSZ5zLlYp9BboyKU0oFGmT0P
-_j4TQ2AHSnOF17bM5AZGkdKBzNBTLREKbMKev5ZF6ot1
oAoeau9EldgOs74vBiKhGoUKSIbJl5E9cOXUmWCrUribl
StRQkA-JSUEhkuZnReOEM83VEeVvaHYVtcxXydpIo55ec
Pg6EOTMlO41UDu3dExos0ssOVSUg",
    "keyId": "invalidKeyId"
  },
  "owner": {
    "name": {
      "first": "John",
      "middle": "M",
      "last": "Doe",
      "suffix": "III"
    },
    "address": {
      "addressLine1": "1346 Pleasant Ave",
      "addressLine2": "Apt A123",
      "city": "Salt Lake City",
      "state": "UT",
      "postalCode": "12345",
      "country": "US"
    },
    "phone": {
      "countryCode": "1",
      "number": "5556667777"
    }
  }
}		 RESPONSE BODY
{
    "requestId":
"48d9516081a611ee9b7427220cc6c212",
    "code": "extToucan",
    "subCode": 400,
    "context": {
        "errorCode": "3C3E1402"
    },
    "message": "card.keyID"
}
400 transfer-to/combo/create Pull requestValidateError - Must not be less than allowed minimum REQUEST BODY
{
  "transferType": "pull",
  "reference": "exrnlPllTnId2001",
  "cFiCardId": "tcrd_1AXvpht43m432u6UHpu07w",
  "amount": -10.01,
  "currency": "USD",
  "narrative": "For invoice #123",
  "softDescriptor": {
    "name": "Sample Merchant",
    "address": {
      "addressLine1": "1346 Pleasant Ave",
      "addressLine2": "Apt A123",
      "city": "Salt Lake City",
      "state": "PA",
      "postalCode": "12345",
      "country": "US"
    },
    "phone": {
      "countryCode": "1",
      "number": "5556667777"
    },
    "email": "merchant@sample.com"
  } 
}		 RESPONSE BODY
{
    "requestId":
"cd827ac079a111eeb5658f28ab5fe311",
    "code": "requestValidateError",
    "context": [
        {
            "instancePath": "",
            "schemaPath": "#/oneOf/0/required",
            "keyword": "required",
            "params": {
                "missingProperty": "endUserAccount"
            },
            "message": "must have required property
'endUserAccount'"
        },
        {
            "instancePath": "/amount",
            "schemaPath":
"common#/definitions/amount/exclusiveMinimum"
,
            "keyword": "exclusiveMinimum",
            "params": {
                "comparison": ">",
                "limit": 0
            },
            "message": "must be > 0"
        },
        {
            "instancePath": "",
            "schemaPath": "#/oneOf/2/required",
            "keyword": "required",
            "params": {
                "missingProperty": "effectiveEntryDate"
            },
            "message": "must have required property
'effectiveEntryDate'"
        },
        {
            "instancePath": "",
            "schemaPath": "#/oneOf",
            "keyword": "oneOf",
            "params": {
                "passingSchemas": null
            },
            "message": "must match exactly one schema in oneOf"
        }
    ]
}
400 transfer-to/combo/create Pull requestValidateError - Missing required property REQUEST BODY
{
  "transferType": "pull",
  "reference": "exrnlPllTnId2002",
  "cFiCardId": "tcrd_1AXvpht43m432u6UHpu07w",
  "amount": 10.01,
  "narrative": "For invoice #123",
  "softDescriptor": {
    "name": "Sample Merchant",
    "address": {
      "addressLine1": "1346 Pleasant
Aveeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee
eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee
eeeeeeeeeeeeee",
      "addressLine2": "Apt A123",
      "city": "Salt Lake City",
      "state": "PA",
      "postalCode": "12345",
      "country": "US"
    },
    "phone": {
      "countryCode": "1",
      "number": "5556667777"
    },
    "email": "merchant@sample.com"
  } 
}		 RESPONSE BODY
{
    "requestId":
"3ad981e079a211eeb5658f28ab5fe311",
    "code": "requestValidateError",
    "context": [
        {
            "instancePath": "",
            "schemaPath": "#/oneOf/0/required",
            "keyword": "required",
            "params": {
                "missingProperty": "currency"
            },
            "message": "must have required property
'currency'"
        },
        {
            "instancePath": "",
            "schemaPath": "#/oneOf/1/required",
            "keyword": "required",
            "params": {
                "missingProperty": "currency"
            },
            "message": "must have required property
'currency'"
        },
        {
            "instancePath": "",
            "schemaPath": "#/oneOf/2/required",
            "keyword": "required",
            "params": {
                "missingProperty": "effectiveEntryDate"
            },
            "message": "must have required property
'effectiveEntryDate'"
        },
        {
            "instancePath": "",
            "schemaPath": "#/oneOf",
            "keyword": "oneOf",
            "params": {
                "passingSchemas": null
            },
            "message": "must match exactly one schema in oneOf"
        }
    ]
}
400 transfer-to/combo/create Ach requestValidateError - Must be an allowed value REQUEST BODY
{
    "transferType": "ach",
  "reference": "extTrnAch202",
    "effectiveEntryDate": "2023-11-03",
    "standardEntryClassCode": "unknownSECCode",
    "individualName": "John Smith",
    "routingNumber": "053207766",
    "DFIAccountNumber": "123456789",
    "accountType": "Checking",
    "transactionType": "Credit",
    "amount": 3.15,
  "currency": "USD",
    "companyEntryDescription": "PAYMENT",
    "webhookUrl":
"https://your_webhook_url/extTrnAch202"
}		 RESPONSE BODY
{
    "requestId":
"e68b728079a411eeb5658f28ab5fe311",
    "code": "requestValidateError",
    "context": [
        {
            "instancePath": "",
            "schemaPath": "#/oneOf/0/required",
            "keyword": "required",
            "params": {
                "missingProperty": "endUserAccount"
            },
            "message": "must have required property
'endUserAccount'"
        },
        {
            "instancePath": "",
            "schemaPath": "#/oneOf/1/required",
            "keyword": "required",
            "params": {
                "missingProperty": "cFiCardId"
            },
            "message": "must have required property
'cFiCardId'"
        },
        {
            "instancePath": "/standardEntryClassCode",
            "schemaPath":
"ach#/definitions/standardEntryClassCode/enum
",
            "keyword": "enum",
            "params": {
                "allowedValues": [
                    "ARC",
                    "BOC",
                    "CIE",
                    "CCD",
                    "CTX",
                    "POP",
                    "PPD",
                    "RCK",
                    "TEL",
                    "WEB"
                ]
            },
            "message": "must be equal to one of the allowed
values"
        },
        {
            "instancePath": "",
            "schemaPath": "#/oneOf",
            "keyword": "oneOf",
            "params": {
                "passingSchemas": null
            },
            "message": "must match exactly one schema in oneOf"
        }
    ]
}
400 transfer-to/combo/query cFiTransactionIds requestValidateError - Missing required property REQUEST BODY
{
    "cFiTransactionIds": [
      {"cFiTransactionId":
"CLIENTID_5sgMbmRj2HzTUx5jOFccnw"},
      {"transferType": "push", "cFiTransactionId":
"CLIENTID_7cLPRxUEe1PcERTfArLwHM"},
      {"transferType": "wire", "cFiTransactionId":
"CLIENTID_6GjbDZwkm3SieyS4IpQP7A"},
      {"transferType": "pull", "cFiTransactionId":
"CLIENTID_600u0FY9DNdRihmYe7icMy"},
      {"transferType": "push", "cFiTransactionId":
"CLIENTID_01m6InYtVfqMPb9HS3wxVg"},
      {"transferType": "wire", "cFiTransactionId":
"CLIENTID_LO7PHImGsvvR46Z7E1hwS"},
      {"transferType": "ach",
        "cFiTransactionId":
"CLIENTID_16miQKjs2NjZVzrf8ouBQm"}
    ]
}		 RESPONSE BODY
{
    "requestId":
"2ba0d77079a511eeb5658f28ab5fe311",
    "code": "requestValidateError",
    "context": [
        {
            "instancePath": "/cFiTransactionIds/0",
            "schemaPath": "#/required",
            "keyword": "required",
            "params": {
                "missingProperty": "transferType"
            },
            "message": "must have required property
'transferType'"
        },
        {
            "instancePath": "",
            "schemaPath": "#/oneOf/1/required",
            "keyword": "required",
            "params": {
                "missingProperty": "references"
            },
            "message": "must have required property
'references'"
        },
        {
            "instancePath": "",
            "schemaPath": "#/oneOf",
            "keyword": "oneOf",
            "params": {
                "passingSchemas": null
            },
            "message": "must match exactly one schema in oneOf"
        }
    ]
}
400 transfer-to/combo/query cFiTransactionIds requestValidateError - Must not have fewer than minimum items REQUEST BODY
{
    "cFiTransactionIds": [
      
    ]
}		 RESPONSE BODY
{
    "requestId":
"5d144bc079a511eeb5658f28ab5fe311",
    "code": "requestValidateError",
    "context": [
        {
            "instancePath": "/cFiTransactionIds",
            "schemaPath":
"#/oneOf/0/properties/cFiTransactionIds/minIt
ems",
            "keyword": "minItems",
            "params": {
                "limit": 1
            },
            "message": "must NOT have fewer than 1 items"
        },
        {
            "instancePath": "",
            "schemaPath": "#/oneOf/1/required",
            "keyword": "required",
            "params": {
                "missingProperty": "references"
            },
            "message": "must have required property
'references'"
        },
        {
            "instancePath": "",
            "schemaPath": "#/oneOf",
            "keyword": "oneOf",
            "params": {
                "passingSchemas": null
            },
            "message": "must match exactly one schema in oneOf"
        }
    ]
}