{"__v":8,"_id":"571f8856435301190079f75a","api":{"auth":"required","params":[],"results":{"codes":[]},"settings":"","url":""},"body":"[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"What do you want to do?\"\n}\n[/block]\nThe FundraisingBox provides different APIs for different purposes:\n\n##Synchronize external services\nHave a look at our [Webhooks](doc:what-is-a-webhook) to process data automatically to your ERP, CRM or special webservice.\n\n##Propagate values into the FundraisingBox iFrame form\nThe simple [Form-Prepopulation-API](doc:form-prepopulation-api) is the right choice for you.\n\n##Complex prepopulation, e.g. for shopping cart or multi step forms\nUse our serverside [Session-API](doc:session-api-introduction) to store and validate data and submit this session to the iFrame form. \n\n##Create highly individual donation forms with automatic validation and payment\nOur [Form-API](doc:form-api) provides you a mighty Javascript jQuery-Plugin for single and multi step forms. Just write your own HTML code!\n\n##Process payments with your server\nThe [Payment-API](doc:payment-api) can process values directly or you submit a session.\n\n##Build custom crowdfunding themes\nThe [FundraisingPage-JSON-API](doc:fundraising-page-json-api) provides you a JSON that you can use to build highly individual fundraising pages.\n\n##Access FundraisingBox objects\nOur [REST-API](doc:rest-api) provides you several objects as XML.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"All APIs have a daily access limit (calls per second and calls per day). \\nPlease check how many calls you have available in your FundraisingBox plan.\\n\\nWebhooks do not have any restrictions.\",\n  \"title\": \"API access limits\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"SSL Validation\"\n}\n[/block]\nFor defeating the \"man in the middle\" you need to verify the certificate being presented to you.\nYou can do this by comparing it against Mozilla’s CA certificate bundle.\n\nBy default a curl installation (e.g. PHP curl) already uses an existing cacert.pem file.\nIf you get an error similar to „Peer’s Certificate issuer is not recognized.“ please update your cacert.pem from [https://curl.haxx.se/docs/caextract.html](https://curl.haxx.se/docs/caextract.html).\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"HTTPS\",\n  \"body\": \"Always use [https://secure.fundraisingbox.com](https://secure.fundraisingbox.com)! If you perform a request on http you will get a redirect answer in return.\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Conventions in the documentation\"\n}\n[/block]\nIn the documentation that follows, the following notation is used:\n\n    {text}: Indicates text that should be replaced by your own data.\n    \n    ...: Indicates content from the response has been elided for brevity in documentation.","category":"571f884be54f2d0e003ebb0a","createdAt":"2016-04-26T15:25:10.700Z","excerpt":"Short overview","githubsync":"","hidden":false,"isReference":false,"link_external":false,"link_url":"","order":0,"parentDoc":null,"project":"571f5e8cd8667f0e00a3c498","slug":"how-to-start","sync_unique":"","title":"How to start","type":"basic","updates":[],"user":"571f5e46d8e3cf1900762b33","version":"571f5e8cd8667f0e00a3c49b","childrenPages":[]}

How to start

Short overview

[block:api-header] { "type": "basic", "title": "What do you want to do?" } [/block] The FundraisingBox provides different APIs for different purposes: ##Synchronize external services Have a look at our [Webhooks](doc:what-is-a-webhook) to process data automatically to your ERP, CRM or special webservice. ##Propagate values into the FundraisingBox iFrame form The simple [Form-Prepopulation-API](doc:form-prepopulation-api) is the right choice for you. ##Complex prepopulation, e.g. for shopping cart or multi step forms Use our serverside [Session-API](doc:session-api-introduction) to store and validate data and submit this session to the iFrame form. ##Create highly individual donation forms with automatic validation and payment Our [Form-API](doc:form-api) provides you a mighty Javascript jQuery-Plugin for single and multi step forms. Just write your own HTML code! ##Process payments with your server The [Payment-API](doc:payment-api) can process values directly or you submit a session. ##Build custom crowdfunding themes The [FundraisingPage-JSON-API](doc:fundraising-page-json-api) provides you a JSON that you can use to build highly individual fundraising pages. ##Access FundraisingBox objects Our [REST-API](doc:rest-api) provides you several objects as XML. [block:callout] { "type": "info", "body": "All APIs have a daily access limit (calls per second and calls per day). \nPlease check how many calls you have available in your FundraisingBox plan.\n\nWebhooks do not have any restrictions.", "title": "API access limits" } [/block] [block:api-header] { "type": "basic", "title": "SSL Validation" } [/block] For defeating the "man in the middle" you need to verify the certificate being presented to you. You can do this by comparing it against Mozilla’s CA certificate bundle. By default a curl installation (e.g. PHP curl) already uses an existing cacert.pem file. If you get an error similar to „Peer’s Certificate issuer is not recognized.“ please update your cacert.pem from [https://curl.haxx.se/docs/caextract.html](https://curl.haxx.se/docs/caextract.html). [block:callout] { "type": "warning", "title": "HTTPS", "body": "Always use [https://secure.fundraisingbox.com](https://secure.fundraisingbox.com)! If you perform a request on http you will get a redirect answer in return." } [/block] [block:api-header] { "type": "basic", "title": "Conventions in the documentation" } [/block] In the documentation that follows, the following notation is used: {text}: Indicates text that should be replaced by your own data. ...: Indicates content from the response has been elided for brevity in documentation.