{"_id":"5d8e4cfc34146a0012ca5b2a","project":"550f74bb6fc8130d0038aad3","version":{"_id":"550f75de61d9d30d00af9e01","__v":17,"project":"550f74bb6fc8130d0038aad3","forked_from":"550f74bb6fc8130d0038aad6","createdAt":"2015-03-23T02:09:34.221Z","releaseDate":"2015-03-23T02:09:34.221Z","categories":["550f75de61d9d30d00af9e02","551027e38579861900a86698","551029e08579861900a8669a","551029e7498062190006328a","5bc633a722d682005c9ad9e4","5bc633b08c4b0b000d6a7eaa","5bc633b48f3ff600626e3e18","5bc63538e5a6ba000d22ee6d","5bc63587a18a6b000decd295","5bc635c0937fcb0056223d9c","5bc6360f42f41800319aeaa6","5be5d13ff1d319002baca9ce","5be5d2287cd14d00291fbfdb","5be8b3b09f7cb70023c56a39","5be8b3cbb910100044e20206","5c1d769a4f6aed001fe527f0","5c402942010f0d001496dded"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"3.0.0","version":"3"},"category":{"_id":"5bc63538e5a6ba000d22ee6d","project":"550f74bb6fc8130d0038aad3","version":"550f75de61d9d30d00af9e01","__v":0,"sync":{"url":"","isSync":false},"reference":true,"createdAt":"2018-10-16T19:00:08.331Z","from_sync":false,"order":1,"slug":"wyre-sdk","title":"Widget"},"user":"5c8fb57a338d71002afda886","__v":0,"parentDoc":null,"metadata":{"title":"","description":"","image":[]},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2019-09-27T17:55:08.998Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":true,"order":10,"body":"The Wyre Widget is an easy-to-embed web module aimed to provide fiat on-ramps for your customers via debit card and ACH payment processing. \n\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 vs ACH\"\n}\n[/block]\nYou have the option of providing users with a Debit Card or ACH payment flow. If you choose to use the ACH flow, please read this [article](https://support.sendwyre.com/transfers/ach-transfers) on general information about ACH and its limitations. \n\n**Debit Card Payments**\nThere are three ways to provide debit card payments for users using the widget. You have the option of providing users with Apple Pay, Google Pay or Masterpass.\n\n**ACH Payments**\nWe currently use [Plaid](https://www.plaid.com) to connect to bank accounts to fund. In the test environment, the user can select any bank vendor. For username, type in `user_good` and for password, type in `pass_good` which are the Plaid test credentials\n\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.","excerpt":"","slug":"widget-getting-started-2","type":"basic","title":"Getting Started"}
The Wyre Widget is an easy-to-embed web module aimed to provide fiat on-ramps for your customers via debit card and ACH payment processing. [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 vs ACH" } [/block] You have the option of providing users with a Debit Card or ACH payment flow. If you choose to use the ACH flow, please read this [article](https://support.sendwyre.com/transfers/ach-transfers) on general information about ACH and its limitations. **Debit Card Payments** There are three ways to provide debit card payments for users using the widget. You have the option of providing users with Apple Pay, Google Pay or Masterpass. **ACH Payments** We currently use [Plaid](https://www.plaid.com) to connect to bank accounts to fund. In the test environment, the user can select any bank vendor. For username, type in `user_good` and for password, type in `pass_good` which are the Plaid test credentials [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.