{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","results":{"codes":[]},"settings":"","params":[]},"next":{"description":"","pages":[]},"title":"Wallet Order Creation Exceptions","type":"basic","slug":"wallet-order-creation-exceptions","excerpt":"","body":"Order Creation Exceptions are thrown at the time of order creation because of an issue with the request.Wallet Order Creation Exceptions\n\nOrder Creation Exceptions are thrown at the time of order creation because of an issue with the request.\n\nExceptions follow the API error format: link:\n\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n    \\\"language\\\": \\\"en\\\",\\n    \\\"exceptionId\\\": \\\"TLFN89\\\",\\n    \\\"errorCode\\\": \\\"validation.unsupportedCardType.credit\\\",\\n    \\\"message\\\": \\\"Credit cards are not supported\\\",\\n    \\\"type\\\": \\\"ValidationException\\\",\\n    \\\"transient\\\": false\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\nA list of errors can be found below:\n\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Type\",\n    \"h-1\": \"Error Code\",\n    \"0-0\": \"ValidationException\",\n    \"0-1\": \"validation.unsupportedCardType.credit\",\n    \"h-2\": \"Message\",\n    \"0-2\": \"Credit cards are not supported\",\n    \"1-0\": \"ValidationException\",\n    \"1-1\": \"validation.unsupportedCardType.prepaid\",\n    \"1-2\": \"PrePaid cards are not supported\",\n    \"2-0\": \"ValidationException\",\n    \"2-1\": \"validation.avs\",\n    \"2-2\": \"We are not able to use this card.\",\n    \"22-0\": \"`secretKey`\",\n    \"22-1\": \"**(only if auth_type is secretKey)** More information [here](https://docs.sendwyre.com/docs/widget-api#authorization)\\n\\n**Optional**\",\n    \"22-2\": \"`your_secret_key`\",\n    \"12-0\": \"ValidationException\",\n    \"12-1\": \"validation.missingGivenName\",\n    \"12-2\": \"givenName must not be empty\",\n    \"13-0\": \"ValidationException\",\n    \"13-1\": \"validation.missingFamilyName\",\n    \"13-2\": \"familyName must not be empty\",\n    \"21-0\": \"`accountId`\",\n    \"21-1\": \"Your Wyre Account ID. This associates accounts created inside the widget with you, though it does not give you access to their details\",\n    \"0-3\": \"\",\n    \"3-0\": \"ValidationException\",\n    \"4-0\": \"ValidationException\",\n    \"5-0\": \"ValidationException\",\n    \"6-0\": \"ValidationException\",\n    \"7-0\": \"ValidationException\",\n    \"8-0\": \"ValidationException\",\n    \"9-0\": \"ValidationException\",\n    \"10-0\": \"ValidationException\",\n    \"11-0\": \"ValidationException\",\n    \"h-3\": \"Notes\",\n    \"14-0\": \"ValidationException\",\n    \"15-0\": \"ValidationException\",\n    \"16-0\": \"ValidationException\",\n    \"4-1\": \"validation.avs.incorrectBillingAddress\",\n    \"2-3\": \"General card validation failure, further details on why the card doesn’t work are unavailable.\",\n    \"3-1\": \"validation.avs.invalidBillingAddress\",\n    \"3-2\": \"Invalid billing address\",\n    \"4-2\": \"Invalid billing address. Your address is incorrect\",\n    \"5-1\": \"validation.avs.zipcode\",\n    \"5-2\": \"Invalid billing address. Zip code is incorrect\",\n    \"6-1\": \"validation.avs.unavailable\",\n    \"6-2\": \"Invalid billing address. We were not able to validate your address. Try again later.\",\n    \"6-3\": \"If our address validation service is unavailable the user will have to try the transaction later\",\n    \"7-1\": \"validation.invalidReferrerId\",\n    \"7-2\": \"Invalid referrerAccountId\",\n    \"8-1\": \"validation.phoneNumRequiresCountryCode\",\n    \"8-2\": \"Please include your country code preceded by a \\\"+\\\" with your phone number\",\n    \"9-1\": \"validation.unsupportedCountry\",\n    \"9-2\": \"Country not supported: “XX”\",\n    \"9-3\": \"XX is country code submitted by user\",\n    \"10-1\": \"validation.invalidUsState\",\n    \"10-2\": \"Invalid US state submitted\",\n    \"11-1\": \"validation.missingAddressState\",\n    \"11-2\": \"Address state must not be empty\",\n    \"14-1\": \"limits.dailyLimitReached\",\n    \"14-2\": \"You reached your daily limit.\",\n    \"15-1\": \"limits.weeklyLimitReached\",\n    \"15-2\": \"You reached your weekly limit.\",\n    \"16-1\": \"limits.yearlyLimitReached\",\n    \"16-2\": \"You reached your yearly limit\",\n    \"20-0\": \"ApiException\",\n    \"20-1\": \"n/a\",\n    \"20-2\": \"n/a\",\n    \"20-3\": \"If there is an unhandled error by the API it will appear as an ApiException without an error code or message\",\n    \"17-0\": \"ValidationException\",\n    \"17-1\": \"validation .invalidPhoneNumber\",\n    \"17-2\": \"You did not specify a valid E164 Phone number. \\nPhone numbers must follow the International [E.164](https://en.wikipedia.org/wiki/E.164#:~:text=E.164%20defines%20a%20general,excluding%20the%20international%20call%20prefix.&text=As%20described%20in%20by%20the,code%20(1%20to%203%20digits)) format.\",\n    \"18-0\": \"ValidationException\",\n    \"18-1\": \"validation.missingAddressCity\",\n    \"18-2\": \"Cityt is mandatory\",\n    \"19-0\": \"ValidationException\",\n    \"19-1\": \"validation.stateNotSupported\",\n    \"19-2\": \"If you specify a non supported US state. More info [here](https://app.gitbook.com/:::at:::wyre-1/s/wyre-inital-docs/wyre-card-processing/the-wyre-widget/untitled).\"\n  },\n  \"cols\": 4,\n  \"rows\": 21\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"Wallet Order Errors\"\n}\n[/block]\nError messages are failures that happen after the order has been created. These errors will show up over 3 fields on the wallet order:\n\n`errorCategory`\n`errorCode`\n`errorMessage`\n\nA full list of errors can be found below:\n\n\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"errorCategory\",\n    \"h-1\": \"errorCode\",\n    \"h-2\": \"errorMessage\",\n    \"h-3\": \"Notes\",\n    \"0-0\": \"GENERAL\",\n    \"1-0\": \"GENERAL\",\n    \"2-0\": \"GENERAL\",\n    \"3-0\": \"GENERAL\",\n    \"4-0\": \"GENERAL\",\n    \"5-0\": \"GENERAL\",\n    \"6-0\": \"GENERAL\",\n    \"0-1\": \"UNSUPPORTED_COUNTRY\",\n    \"0-2\": \"We do not support this country.\",\n    \"1-1\": \"UNSUPPORTED_STATE\",\n    \"1-2\": \"We do not support this state at this time but hope to soon.\",\n    \"2-1\": \"UNABLE_TO_PROCESS\",\n    \"2-2\": \"Sorry, but we are unable to process your order at this time.\",\n    \"3-1\": \"SMS_CONFIRMATION_FAILED\",\n    \"3-2\": \"SMS confirmation failed\",\n    \"4-1\": \"PHONE_NUMBER_MUST_BE_MOBILE\",\n    \"4-2\": \"Only mobile cellphone numbers are supported.\",\n    \"5-1\": \"TRANSACTION_TIMEOUT\",\n    \"5-2\": \"Transaction timed out, please try again.\",\n    \"6-1\": \"UNKNOWN_ERROR\",\n    \"6-2\": \"We are unable to process your order at this time.\",\n    \"3-3\": \"For debit card tx only\",\n    \"7-0\": \"PAYMENT\",\n    \"8-0\": \"PAYMENT\",\n    \"10-0\": \"PAYMENT\",\n    \"7-1\": \"ISO_8583_XX\",\n    \"8-1\": \"BILLING_ADDRESS_MISMATCH\",\n    \"10-1\": \"UNKNOWN_ERROR\",\n    \"7-2\": \"See ISO 8583 error message list ->\",\n    \"7-3\": \"XX replaced by ISO 8583 code. See full list here: https://developers.google.com/standard-payments/v1/fops/card/response-codes\",\n    \"8-2\": \"Billing address error, please check your info and try again.\",\n    \"10-2\": \"Issue with payment, please check your info and try again\",\n    \"11-0\": \"RATE_LIMIT\",\n    \"12-0\": \"RATE_LIMIT\",\n    \"13-0\": \"RATE_LIMIT\",\n    \"14-0\": \"RATE_LIMIT\",\n    \"11-1\": \"EXCEEDED_DAILY_LIMIT\",\n    \"11-2\": \"Transaction limit exceeded, please try again later.\",\n    \"12-1\": \"EXCEEDED_WEEKLY_LIMIT\",\n    \"12-2\": \"Transaction limit exceeded, please try again later.\",\n    \"13-1\": \"EXCEEDED_YEARLY_LIMIT\",\n    \"13-2\": \"Transaction limit exceeded, please try again later.\",\n    \"14-1\": \"ORDER_AMOUNT_TOO_HIGH\",\n    \"14-2\": \"Transaction amount too high, please try a smaller amount.\",\n    \"9-0\": \"PAYMENT\",\n    \"9-1\": \"THREE_D_SECURE_AUTHENTICATION_FAILED\",\n    \"9-2\": \"3DS authentication failed.\"\n  },\n  \"cols\": 4,\n  \"rows\": 15\n}\n[/block]","updates":["5eb05ad74075d00029eb1fa8"],"order":999,"isReference":true,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5eab352229feff0021998ff2","createdAt":"2020-04-30T20:29:22.735Z","user":"5dcd9f0b28d74f003b86eca6","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Widget","slug":"wyre-sdk","order":1,"from_sync":false,"reference":true,"_id":"5bc63538e5a6ba000d22ee6d","project":"550f74bb6fc8130d0038aad3","version":"550f75de61d9d30d00af9e01","createdAt":"2018-10-16T19:00:08.331Z","__v":0},"version":{"version":"3","version_clean":"3.0.0","codename":"","is_stable":true,"is_beta":true,"is_hidden":false,"is_deprecated":false,"categories":["550f75de61d9d30d00af9e02","551027e38579861900a86698","551029e08579861900a8669a","551029e7498062190006328a","5bc633a722d682005c9ad9e4","5bc633b08c4b0b000d6a7eaa","5bc633b48f3ff600626e3e18","5bc63538e5a6ba000d22ee6d","5bc63587a18a6b000decd295","5bc635c0937fcb0056223d9c","5bc6360f42f41800319aeaa6","5be5d13ff1d319002baca9ce","5be5d2287cd14d00291fbfdb","5be8b3b09f7cb70023c56a39","5be8b3cbb910100044e20206","5c1d769a4f6aed001fe527f0","5c402942010f0d001496dded","5e8127d61c906800374eeb1c"],"_id":"550f75de61d9d30d00af9e01","__v":18,"releaseDate":"2015-03-23T02:09:34.221Z","project":"550f74bb6fc8130d0038aad3","createdAt":"2015-03-23T02:09:34.221Z","forked_from":"550f74bb6fc8130d0038aad6"},"project":"550f74bb6fc8130d0038aad3","__v":1}

Wallet Order Creation Exceptions


Order Creation Exceptions are thrown at the time of order creation because of an issue with the request.Wallet Order Creation Exceptions Order Creation Exceptions are thrown at the time of order creation because of an issue with the request. Exceptions follow the API error format: link: [block:code] { "codes": [ { "code": "{\n \"language\": \"en\",\n \"exceptionId\": \"TLFN89\",\n \"errorCode\": \"validation.unsupportedCardType.credit\",\n \"message\": \"Credit cards are not supported\",\n \"type\": \"ValidationException\",\n \"transient\": false\n}", "language": "json" } ] } [/block] A list of errors can be found below: [block:parameters] { "data": { "h-0": "Type", "h-1": "Error Code", "0-0": "ValidationException", "0-1": "validation.unsupportedCardType.credit", "h-2": "Message", "0-2": "Credit cards are not supported", "1-0": "ValidationException", "1-1": "validation.unsupportedCardType.prepaid", "1-2": "PrePaid cards are not supported", "2-0": "ValidationException", "2-1": "validation.avs", "2-2": "We are not able to use this card.", "22-0": "`secretKey`", "22-1": "**(only if auth_type is secretKey)** More information [here](https://docs.sendwyre.com/docs/widget-api#authorization)\n\n**Optional**", "22-2": "`your_secret_key`", "12-0": "ValidationException", "12-1": "validation.missingGivenName", "12-2": "givenName must not be empty", "13-0": "ValidationException", "13-1": "validation.missingFamilyName", "13-2": "familyName must not be empty", "21-0": "`accountId`", "21-1": "Your Wyre Account ID. This associates accounts created inside the widget with you, though it does not give you access to their details", "0-3": "", "3-0": "ValidationException", "4-0": "ValidationException", "5-0": "ValidationException", "6-0": "ValidationException", "7-0": "ValidationException", "8-0": "ValidationException", "9-0": "ValidationException", "10-0": "ValidationException", "11-0": "ValidationException", "h-3": "Notes", "14-0": "ValidationException", "15-0": "ValidationException", "16-0": "ValidationException", "4-1": "validation.avs.incorrectBillingAddress", "2-3": "General card validation failure, further details on why the card doesn’t work are unavailable.", "3-1": "validation.avs.invalidBillingAddress", "3-2": "Invalid billing address", "4-2": "Invalid billing address. Your address is incorrect", "5-1": "validation.avs.zipcode", "5-2": "Invalid billing address. Zip code is incorrect", "6-1": "validation.avs.unavailable", "6-2": "Invalid billing address. We were not able to validate your address. Try again later.", "6-3": "If our address validation service is unavailable the user will have to try the transaction later", "7-1": "validation.invalidReferrerId", "7-2": "Invalid referrerAccountId", "8-1": "validation.phoneNumRequiresCountryCode", "8-2": "Please include your country code preceded by a \"+\" with your phone number", "9-1": "validation.unsupportedCountry", "9-2": "Country not supported: “XX”", "9-3": "XX is country code submitted by user", "10-1": "validation.invalidUsState", "10-2": "Invalid US state submitted", "11-1": "validation.missingAddressState", "11-2": "Address state must not be empty", "14-1": "limits.dailyLimitReached", "14-2": "You reached your daily limit.", "15-1": "limits.weeklyLimitReached", "15-2": "You reached your weekly limit.", "16-1": "limits.yearlyLimitReached", "16-2": "You reached your yearly limit", "20-0": "ApiException", "20-1": "n/a", "20-2": "n/a", "20-3": "If there is an unhandled error by the API it will appear as an ApiException without an error code or message", "17-0": "ValidationException", "17-1": "validation .invalidPhoneNumber", "17-2": "You did not specify a valid E164 Phone number. \nPhone numbers must follow the International [E.164](https://en.wikipedia.org/wiki/E.164#:~:text=E.164%20defines%20a%20general,excluding%20the%20international%20call%20prefix.&text=As%20described%20in%20by%20the,code%20(1%20to%203%20digits)) format.", "18-0": "ValidationException", "18-1": "validation.missingAddressCity", "18-2": "Cityt is mandatory", "19-0": "ValidationException", "19-1": "validation.stateNotSupported", "19-2": "If you specify a non supported US state. More info [here](https://app.gitbook.com/@wyre-1/s/wyre-inital-docs/wyre-card-processing/the-wyre-widget/untitled)." }, "cols": 4, "rows": 21 } [/block] [block:api-header] { "title": "Wallet Order Errors" } [/block] Error messages are failures that happen after the order has been created. These errors will show up over 3 fields on the wallet order: `errorCategory` `errorCode` `errorMessage` A full list of errors can be found below: [block:parameters] { "data": { "h-0": "errorCategory", "h-1": "errorCode", "h-2": "errorMessage", "h-3": "Notes", "0-0": "GENERAL", "1-0": "GENERAL", "2-0": "GENERAL", "3-0": "GENERAL", "4-0": "GENERAL", "5-0": "GENERAL", "6-0": "GENERAL", "0-1": "UNSUPPORTED_COUNTRY", "0-2": "We do not support this country.", "1-1": "UNSUPPORTED_STATE", "1-2": "We do not support this state at this time but hope to soon.", "2-1": "UNABLE_TO_PROCESS", "2-2": "Sorry, but we are unable to process your order at this time.", "3-1": "SMS_CONFIRMATION_FAILED", "3-2": "SMS confirmation failed", "4-1": "PHONE_NUMBER_MUST_BE_MOBILE", "4-2": "Only mobile cellphone numbers are supported.", "5-1": "TRANSACTION_TIMEOUT", "5-2": "Transaction timed out, please try again.", "6-1": "UNKNOWN_ERROR", "6-2": "We are unable to process your order at this time.", "3-3": "For debit card tx only", "7-0": "PAYMENT", "8-0": "PAYMENT", "10-0": "PAYMENT", "7-1": "ISO_8583_XX", "8-1": "BILLING_ADDRESS_MISMATCH", "10-1": "UNKNOWN_ERROR", "7-2": "See ISO 8583 error message list ->", "7-3": "XX replaced by ISO 8583 code. See full list here: https://developers.google.com/standard-payments/v1/fops/card/response-codes", "8-2": "Billing address error, please check your info and try again.", "10-2": "Issue with payment, please check your info and try again", "11-0": "RATE_LIMIT", "12-0": "RATE_LIMIT", "13-0": "RATE_LIMIT", "14-0": "RATE_LIMIT", "11-1": "EXCEEDED_DAILY_LIMIT", "11-2": "Transaction limit exceeded, please try again later.", "12-1": "EXCEEDED_WEEKLY_LIMIT", "12-2": "Transaction limit exceeded, please try again later.", "13-1": "EXCEEDED_YEARLY_LIMIT", "13-2": "Transaction limit exceeded, please try again later.", "14-1": "ORDER_AMOUNT_TOO_HIGH", "14-2": "Transaction amount too high, please try a smaller amount.", "9-0": "PAYMENT", "9-1": "THREE_D_SECURE_AUTHENTICATION_FAILED", "9-2": "3DS authentication failed." }, "cols": 4, "rows": 15 } [/block]