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":
"Snbx7y1UUwOjJ44jUA0OjHWz184mpK5dqaHGGHz
QML7_d6FolgQ25VEq4UusvmSSMCziNF8h7wq2Gjz
JXMO3YghuuYqIw_2VvObd0TevFnjfFGL30qMM8GY
2Q6BzRuXRdHMuy6qT4SPypJnDXbleHeEvjtzGSZ5
zLlYp9BboyKU0oFGmT0P-_j4TQ2AHSnOF17bM5AZ
GkdKBzNBTLREKbMKev5ZF6ot1oAoeau9EldgOs74
vBiKhGoUKSIbJl5E9cOXUmWCrUriblStRQkA-JSU
EhkuZnReOEM83VEeVvaHYVtcxXydpIo55ecPg6EO
TMlO41UDu3dExos0ssOVSUg",
    "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":
"Snbx7y1UUwOjJ44jUA0OjHWz184mpK5dqaHGGHz
QML7_d6FolgQ25VEq4UusvmSSMCziNF8h7wq2Gjz
JXMO3YghuuYqIw_2VvObd0TevFnjfFGL30qMM8GY
2Q6BzRuXRdHMuy6qT4SPypJnDXbleHeEvjtzGSZ5
zLlYp9BboyKU0oFGmT0P-_j4TQ2AHSnOF17bM5AZ
GkdKBzNBTLREKbMKev5ZF6ot1oAoeau9EldgOs74
vBiKhGoUKSIbJl5E9cOXUmWCrUriblStRQkA-JSU
EhkuZnReOEM83VEeVvaHYVtcxXydpIo55ecPg6EO
TMlO41UDu3dExos0ssOVSUg",
    "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/exclusiveMin
imum",
            "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
Aveeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee
eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee
eeeeeeeeeeeeeeeeeeeeeeee",
      "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/
minItems",
            "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"
        }
    ]
}