{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"f2357e7c-e34b-4172-879e-d8f715f4a498","name":"Engiven API Documentation 1.2","description":"Contact Support:  \nName: Engiven Support  \nEmail: [support@engiven.com](mailto:support@engiven.com)\n\n# Engiven API Overview\n\nThe Engiven APIs are intended to allow approved partner platforms to facilitate the offering of cryptocurrency donation and management services to their nonprofit clients.\n\nEngiven’s private APIs allow you to:\n\nCreate and update nonprofit organizations (Customers)\n\nCreate and update designated giving funds associated with nonprofit organizations\n\nInitiate cryptocurrency donations\n\nGet transaction details and histories\n\n# API Utilization Process\n\nTo utilize the Engiven APIs, your partner platform must be approved by Engiven and have entered into a Partner API Agreement with Engiven.\n\n### STEP 1 - Build you Sandbox implementation\n\nAs an approved partner you may request access to the Engiven Sandbox site by emailing [it@engiven.com](mailto:it@engiven.com) and requesting a Sandbox API Key. You will be asked to provide:\n\n1.  IP address(s) for whitelisting\n2.  an optional URL for a Webhook endpoint you can establish to receive transaction confirmations.\n    \n\nEngiven’s team will provide you the API Key for the Engiven Sandbox via SendSafely.\n\n### STEP 2 - Test your Sandbox implementation\n\nTo test your integration you will need to utilize [testnet](https://en.bitcoin.it/wiki/Testnet) coins. The testnet is an alternative Bitcoin block chain to be used for testing. You can request testnet coins via any number of public faucets such as:\n\n[https://coinfaucet.eu/en/btc-testnet/](https://coinfaucet.eu/en/btc-testnet/)\n\n[https://bitcoinfaucet.uo1.net/](https://bitcoinfaucet.uo1.net/)\n\nWe recommend utilizing a faucet as a ‘donor’, and making a request for testnet coins to a faucet using the publicAddress returned from a successful POST to the endpoint [https://api.sandbox.engiven.com/gifts](https://api.sandbox.engiven.com/gifts)\n\n### STEP 3 - Review your Sandbox implementation with Engiven\n\nOnce you have built your implementation, you will work with the Engiven development team to review and finalize. Once you and the Engiven team agree you are ready to move forward you can request production API keys.\n\n### STEP 4 - Request and Receive you Production API Key\n\nRequest your production API key by emailing [it@engiven.com](mailto:it@engiven.com). You will be asked to provide:\n\n1.  IP address(s) for whitelisting\n2.  an optional URL for a Webhook endpoint you can establish to receive transaction confirmations\n    \n\nEngiven’s team will provide you the API Key for the Engiven Production APIs via SendSafely.\n\n# Understanding Flow of Funds and the role of the Fiscal Sponsor\n\nIt is important for Engiven’s Platform Partners and their nonprofit customers to understand the flow of funds related to donations of cryptocurrency made via the API. All donations made via the API are received on behalf of the Partner Platform’s designated nonprofits by Engiven Foundation. Engiven Foundation operates as a project of Players Philanthropy Fund, a Maryland charitable trust recognized by the IRS as a tax-exempt public charity under Section 501(c)(3) of the Internal Revenue Code.\n\nWhen your nonprofit customers’ donors make a cryptocurrency donation, they are in fact making the donation to Engiven Foundation for the benefit of your nonprofit customer. Engiven Foundation, as a fiscal sponsor then grants the resulting USD proceeds to your nonprofit customer. In this way, your nonprofit customers are allowing their donors to make cryptocurrency donations that directly benefit the intended nonprofit without that nonprofit having to actually receive or custody cryptocurrency assets.\n\n# Disbursement of Funds\n\nProceeds from gifts made to your nonprofit customers are dispersed from the fiscal sponsor to the nonprofit customer via mailed check the first full week of the month following the month the gift(s) was made.\n\nEngiven is developing a Plaid integration that will soon allow your nonprofit customers to elect to connect their local bank accounts for free, daily, automatic disbursements.\n\n# Disclosures to Nonprofit Organizations\n\nIn the user flow that is presented to your nonprofit customers who are opting to accept cryptocurrency donations, Engiven requires that you provide a clear description of the flow of funds and the role that the fiscal sponsor (Engiven Foundation) plays; and, that your nonprofit customer acknowledges that they understand that description.\n\nSample acknowledgement language to be presented to your nonprofit customer is below. You may choose to modify or add to this language.\n\n*The cryptocurrency giving option utilizes a fiscal sponsor, Engiven Foundation, which operates as a project of Players Philanthropy Fund, a Maryland charitable trust recognized by IRS as a tax-exempt public charity under Section 501(c)(3) of the Internal Revenue Code. Cryptocurrency gifts made by your donors will be made to Engiven Foundation, with the resulting USD proceeds designated for grant to your nonprofit organization. In very rare situations, Engiven Foundation may not be able to grant the donation proceeds to your organization when, for example, your organization falls out of compliance with a federal or state regulatory authority. If Engiven Foundation cannot grant the donation to your organization, Engiven Foundation may, after consultation with \\[API Platform Partner\\] return the proceeds of the donation to the donor, contact the donor for an alternate recommendation, or select an alternate recipient nonprofit. Proceeds from cryptocurrency gifts made to your organization are dispersed from Engiven Foundation to your organization via mailed check the first full week of the month immediately following the month the gift(s) was made.*\n\n# Required Donor Facing Language\n\n#### Donation Flow Language\n\nIn the donation experience flow, you are required to present the below language within the donation flow prior to presenting the donor with the giving address and QR code received via response from a POST to the endpoint [https://api.sandbox.engiven.com/gifts](https://api.sandbox.engiven.com/gifts) :\n\n*\\[Nonprofit Customer Name\\] is a nonprofit corporation receiving cryptocurrency donations through a fiscal sponsorship with the Engiven Foundation, a project of Players Philanthropy Fund, a Maryland charitable trust recognized by IRS as a tax-exempt public charity under Section 501(c)(3) of the Internal Revenue Code (Federal Tax ID: 27-6601178). Contributions to the Engiven Foundation are tax-deductible to the fullest extent of the law.*\n\n#### Contribution Receipt Language\n\nIncluded in the contribution receipt delivered to the donor, you are required to include the below language:\n\n*Your contribution has been received on behalf of \\[Nonprofit Customer Name\\] by Engiven Foundation.*\n\n*Engiven Foundation operates as a project of Players Philanthropy Fund, a Maryland charitable trust recognized by the IRS as a tax-exempt public charity under Section 501(c)(3) of the Internal Revenue Code (Federal Tax ID: 27-6601178). Contributions to Engiven Foundation are tax-deductible to the fullest extent of the law.*","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"19392324","team":3275032,"collectionId":"f2357e7c-e34b-4172-879e-d8f715f4a498","publishedId":"2s8YeoPDbc","public":true,"publicUrl":"https://apidocs.engiven.com","privateUrl":"https://go.postman.co/documentation/19392324-f2357e7c-e34b-4172-879e-d8f715f4a498","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"documentationLayout":"classic-double-column","customisation":null,"version":"8.10.1","publishDate":"2022-11-11T02:23:18.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{},"logos":{}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/0e0cb51d91e2671b508775d009cdf58ee86d931dac9a67a62afb6a1738fb981d","favicon":"https://res.cloudinary.com/postman/image/upload/v1648861947/team/hf2woubequcqbmjbnym1.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://apidocs.engiven.com/view/metadata/2s8YeoPDbc"}