{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","settings":"","results":{"codes":[]},"params":[]},"next":{"description":"","pages":[]},"title":"Getting Started","type":"basic","slug":"widget-getting-started-2","excerpt":"","body":"The Wyre Widge is available in a hosted form and an easy-to-embed web module aimed to provide fiat on-ramps for your customers via debit card. \n[block:api-header]\n{\n  \"title\": \"Parties Involved\"\n}\n[/block]\n**Wyre** - Wyre is a service provider to you, our partner. We serve liquidity to partners verified by Wyre, and only serve liquidity to verified users. We do not disclose their personal information unless in the event of a regulatory intervention as requested (e.g. subpoena, etc...). \n\n**Partners** - DEX, Dapps, etc. Likely this is you. You have a need to provide users with on ramps to our supported cryptocurrencies.\n\n**Users** - DEX, Dapp end users. They are the ones getting verified and getting the experience from you. Wyre's part in this is purely to facilitate on-boarding into your application for them. \n\n[block:api-header]\n{\n  \"title\": \"Expected User Flow\"\n}\n[/block]\n1. The user will click a button such as \"Buy Crypto\" and then be displayed Wyre Widget.\n2. The Wyre Widget will take the user through a flow with inputs to add a purchase amount, wallet destination, and other required payment details.\n3. User will then complete payment and receive confirmation of the transaction details.\n[block:api-header]\n{\n  \"title\": \"Preparation\"\n}\n[/block]\nBefore attempting to integrate, you'll need to create an account in Wyre's testing environment. Head on over to [testwyre.com](https://www.testwyre.com) to create it to start this process. You may enter dummy information for all required fields, including email, password, address, name, etc. Some validation is still active so single-letter names and bogus addresses may still be rejected. You may upload any image for document upload prompts. When using a production account, you'll need to pass in real KYC information.\n\nAfter a short time, your account should automatically transition to `APPROVED`. (If it does not, please contact support) Once this happens, return to the widget to see you now have access to fund your account!\n\n[block:api-header]\n{\n  \"title\": \"Payment Methods - Debit Cards\"\n}\n[/block]\n\n**Debit Card Payments**\nThere are two ways to provide debit card payments for users using the widget. You have the option of providing users with Apple Pay**, Debit Card. \n\n** Apple Pay will only work with Apple devices and on the Safari browser.\n[block:api-header]\n{\n  \"title\": \"Test Environment\"\n}\n[/block]\nWyre offers a test environment for the hosted debit card widget. The test environment can be accessed at [pay.testwyre.com/purchase](https://pay.testwyre.com/purchase). \n\nTo test transactions please use these provided debit cards. To ensure you have a successful transaction keep transactions <$1. Anything over $10 will fail automatically. \n\n**Test Cards for US and International** \n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Card Type\",\n    \"h-1\": \"Card Number\",\n    \"h-2\": \"Expiration\",\n    \"h-3\": \"CVV\",\n    \"0-0\": \"VISA\",\n    \"0-1\": \"4444333322221111\",\n    \"0-2\": \"10/23\",\n    \"0-3\": \"123\",\n    \"1-0\": \"MasterCard\",\n    \"1-1\": \"5454545454545454\",\n    \"1-2\": \"10/23\",\n    \"1-3\": \"123\"\n  },\n  \"cols\": 4,\n  \"rows\": 2\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"Supported States and Countries\"\n}\n[/block]\n**US Support**\n\nThe Wyre Widget is available in 43 states but is *restricted* from use in:\n\nNew York\nNew Hampshire\nNorth Carolina\nConnecticut\nHawaii\nVermont\nVirginia\n\n**International Support** \n\nThe Widget is currently available in these countries: \n\nAustralia (AU)\nAustria (AT)\nBelgium (BE)\nCanada (CA)\nCzech Republic (CZ)\nDenmark\t(DK)\nEstonia (EE)\nFinland (FI)\n\nGermany\t(DE)\nGreece (GR)\nHong Kong (HK)\nIreland (IE)\nItaly\t(IT)\nLatvia (LV)\nLithuania\t(LT)\nLuxembourg (LU)\nMexico (MX)\nThe Netherlands (NL)\nNew Zealand (NZ)\nNorway (NO)\nPoland (PL)\nPortugal (PT)\nSlovakia (SK)\nSlovenia (SI)\nSpain (ES)\nSweden (SE)\nSwitzerland (CH)\nUnited States (US) \n\n**France (FR) - is temporarily unavailable \n[block:api-header]\n{\n  \"title\": \"Go Live\"\n}\n[/block]\nBefore going live, you'll want to make sure that you:\n\n- Finalize your Partnership Agreement with Wyre\n- Create your production Wyre account and complete KYC\n- Configure the Widget for the `production` environment\n\nThat's it! You're now ready to accept fiat-to-crypto payments natively in your app.","updates":["5e8d94da35e1b80034de1242","5e8d952489a17800118ec451","5e90bc94d482b60011990885","5e90bd02c808e904c6a5c30f","5e90bd6d53643f00516f5aed","5e90bdeacb9205002d0de277"],"order":10,"isReference":true,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5d8e4cfc34146a0012ca5b2a","project":"550f74bb6fc8130d0038aad3","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"},"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},"user":"5c8fb57a338d71002afda886","createdAt":"2019-09-27T17:55:08.998Z","__v":6,"parentDoc":null}
The Wyre Widge is available in a hosted form and an easy-to-embed web module aimed to provide fiat on-ramps for your customers via debit card. [block:api-header] { "title": "Parties Involved" } [/block] **Wyre** - Wyre is a service provider to you, our partner. We serve liquidity to partners verified by Wyre, and only serve liquidity to verified users. We do not disclose their personal information unless in the event of a regulatory intervention as requested (e.g. subpoena, etc...). **Partners** - DEX, Dapps, etc. Likely this is you. You have a need to provide users with on ramps to our supported cryptocurrencies. **Users** - DEX, Dapp end users. They are the ones getting verified and getting the experience from you. Wyre's part in this is purely to facilitate on-boarding into your application for them. [block:api-header] { "title": "Expected User Flow" } [/block] 1. The user will click a button such as "Buy Crypto" and then be displayed Wyre Widget. 2. The Wyre Widget will take the user through a flow with inputs to add a purchase amount, wallet destination, and other required payment details. 3. User will then complete payment and receive confirmation of the transaction details. [block:api-header] { "title": "Preparation" } [/block] Before attempting to integrate, you'll need to create an account in Wyre's testing environment. Head on over to [testwyre.com](https://www.testwyre.com) to create it to start this process. You may enter dummy information for all required fields, including email, password, address, name, etc. Some validation is still active so single-letter names and bogus addresses may still be rejected. You may upload any image for document upload prompts. When using a production account, you'll need to pass in real KYC information. After a short time, your account should automatically transition to `APPROVED`. (If it does not, please contact support) Once this happens, return to the widget to see you now have access to fund your account! [block:api-header] { "title": "Payment Methods - Debit Cards" } [/block] **Debit Card Payments** There are two ways to provide debit card payments for users using the widget. You have the option of providing users with Apple Pay**, Debit Card. ** Apple Pay will only work with Apple devices and on the Safari browser. [block:api-header] { "title": "Test Environment" } [/block] Wyre offers a test environment for the hosted debit card widget. The test environment can be accessed at [pay.testwyre.com/purchase](https://pay.testwyre.com/purchase). To test transactions please use these provided debit cards. To ensure you have a successful transaction keep transactions <$1. Anything over $10 will fail automatically. **Test Cards for US and International** [block:parameters] { "data": { "h-0": "Card Type", "h-1": "Card Number", "h-2": "Expiration", "h-3": "CVV", "0-0": "VISA", "0-1": "4444333322221111", "0-2": "10/23", "0-3": "123", "1-0": "MasterCard", "1-1": "5454545454545454", "1-2": "10/23", "1-3": "123" }, "cols": 4, "rows": 2 } [/block] [block:api-header] { "title": "Supported States and Countries" } [/block] **US Support** The Wyre Widget is available in 43 states but is *restricted* from use in: New York New Hampshire North Carolina Connecticut Hawaii Vermont Virginia **International Support** The Widget is currently available in these countries: Australia (AU) Austria (AT) Belgium (BE) Canada (CA) Czech Republic (CZ) Denmark (DK) Estonia (EE) Finland (FI) Germany (DE) Greece (GR) Hong Kong (HK) Ireland (IE) Italy (IT) Latvia (LV) Lithuania (LT) Luxembourg (LU) Mexico (MX) The Netherlands (NL) New Zealand (NZ) Norway (NO) Poland (PL) Portugal (PT) Slovakia (SK) Slovenia (SI) Spain (ES) Sweden (SE) Switzerland (CH) United States (US) **France (FR) - is temporarily unavailable [block:api-header] { "title": "Go Live" } [/block] Before going live, you'll want to make sure that you: - Finalize your Partnership Agreement with Wyre - Create your production Wyre account and complete KYC - Configure the Widget for the `production` environment That's it! You're now ready to accept fiat-to-crypto payments natively in your app.