{"__v":1,"_id":"5808a37d80074f0f00fc3cb8","category":{"project":"571f5e8cd8667f0e00a3c498","version":"571f5e8cd8667f0e00a3c49b","_id":"571f884be54f2d0e003ebb0a","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-04-26T15:24:59.312Z","from_sync":false,"order":0,"slug":"general","title":"General"},"parentDoc":null,"project":"571f5e8cd8667f0e00a3c498","user":"5720c075db52d01700f5d1e4","version":{"__v":12,"_id":"571f5e8cd8667f0e00a3c49b","hasDoc":true,"hasReference":true,"project":"571f5e8cd8667f0e00a3c498","createdAt":"2016-04-26T12:26:52.312Z","releaseDate":"2016-04-26T12:26:52.312Z","categories":["571f5e8cd8667f0e00a3c49c","571f73cfcb4baa0e00d13a80","571f7451cb4baa0e00d13a88","571f7d2720695f3400f38797","571f7fb0ac2a080e0014c661","571f884be54f2d0e003ebb0a","572200c9ecb38d0e00d80ebd","572c301e7c8eff0e00aaa174","57df91b2c6348d0e0020c452","57e104db9ff1e21900a721ab","57fd04caeaa77f19008b8202","5899c7113514ce0f0014da84"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-10-20T10:59:09.046Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":3,"body":"The FundraisingBox provides you various possibilities to show an individual success page to your donors.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Automatic success page\"\n}\n[/block]\nBy default the donors are sent back to your embed url with a success parameter and the iFrame shows your success message of your form settings. There are several variables you can use to individualize the message. For more details please visit our [Help-Center](https://support.fundraisingbox.com/article/253.html).\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/19f10d8-FundraisingBox_Spendenformular-personalisierte-Erfolgsnachricht.png\",\n        \"FundraisingBox_Spendenformular-personalisierte-Erfolgsnachricht.png\",\n        630,\n        528,\n        \"#f0f1f0\"\n      ],\n      \"sizing\": \"original\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Own individual success URL\"\n}\n[/block]\nIf your FundraisingBox-plan includes this feature you can define your own success URL in your form settings. The donors will now be sent to this url after a successful donation.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/a8855b0-FundraisingBox_spendenformular-einstellungen-eigene-erfolgsseite.png\",\n        \"FundraisingBox_spendenformular-einstellungen-eigene-erfolgsseite.png\",\n        629,\n        100,\n        \"#dce0d9\"\n      ],\n      \"sizing\": \"original\"\n    }\n  ]\n}\n[/block]\nAs you can see in the screenshot, you can append variables to your URL to individualize your success page: \n\n* %amount%\n* %salutation%\n* %title%\n* %first_name%\n* %last_name%\n* %company_name%\n* %country%\n* %fb_transaction_id%\n* %fb_project_id%\n* %fb_item_id%\n* %fb_type_id%\n* %interval%\n* %email%\n* %wants_newsletter%\n* %prepay_pay_text%\n* %prepay_due_date%\n* %prepay_bank_name%\n* %prepay_iban%\n* %prepay_bic%\n* %token%\n* %donation_custom\\_field\\_[ID]%\n* %person_custom\\_field\\_[ID]%\n\n**Examples:**\n```\nhttp://www.musterorganisation.de/danke.html?betrag=%amount%&anrede=%salutation%&vorname=%first_name%&nachname=%last_name%\n\nhttp://www.musterorganisation.de/danke.html?euro=%amount%&name=%first_name%%20%last_name%&projekt=%fb_item_id%\n\nhttp://www.musterorganisation.de/danke.html?amount=%amount%&tracking=%donation_custom_field_123%\n\nAppend and use the token if you want to retrieve the transaction data via REST-API:\nhttp://www.musterorganisation.de/danke.html?token=%token%\n```\n\n**Some hints:**\n* If a company is the donor, only the %company_name% is set, but not %salutation%, %first_name% and %last_name%. \n* You can find the IDs of your custom fields at Settings > Custom fields.\n* %email%, %donation_custom_field_[ID]% and %person_custom_field_[ID]% are not available in all FundraisingBox-plans.\n* Please have a look on [Predefined values](doc:predefined-values) to see which values are possible.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Dynamic individual success URL\"\n}\n[/block]\nIf your FundraisingBox-plan includes the own individual success URL you can even use the [Form-Prepopulation-API](doc:form-prepopulation-api) to define a dynamic success URL. For example: if your donor comes from the project page \"A\" you can set the success URL to \"thankyouA.html\" and if your donor comes from the project page \"B\" you can define \"thankyouB.html\". The parameter to define the URL is \"**success_redirect_url**\".\nOf course you can also use the variables like %amount% etc.\n\n**Examples:**\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"http://www.myorga.com/donate.html?success_redirect_url=http://www.myorga.com/thankyou.html\",\n      \"language\": \"text\"\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Append to Javascript / URL encoding\",\n  \"body\": \"We recommend to append the URL encoded to the Javascript code, so it's not visible in the browser address line and there is no encoding mess up with the parameters.\"\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<script type=\\\"text/javascript\\\" src=\\\"https://secure.fundraisingbox.com/app/paymentJS?hash={your_form_hash}&success_redirect_url=http%3A%2F%2Fwww.myorga.com%2Fthankyou.html%3Famount%3D%25amount%25%26name%3D%25first_name%25\\\"></script>\",\n      \"language\": \"html\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Automatic dynamic success URL\"\n}\n[/block]\nIf your FundraisingBox-plan has unlimited forms available, you can **embed a form anywhere you want**. The embed URL of your form settings is not checked anymore. **The form automatically remembers it's parent URL** and redirects to this URL after a successful donation.\n\n**Example:**\nYour embed URL in your form settings is just \"http://www.myorga.com\".\nNow you include your form to \"http://www.myorga.com/donate.html\" and the same form also to \"http://www.myorga.com/membership.html\".\nAfter a successful donation, the donors will be automatically sent to the origin with success-status: \"http://www.myorga.com/donate.html?fbStatus=successful\" and \"http://www.myorga.com/membership.html?fbStatus=successful\"","excerpt":"","slug":"success-page","type":"basic","title":"Success page"}
The FundraisingBox provides you various possibilities to show an individual success page to your donors. [block:api-header] { "type": "basic", "title": "Automatic success page" } [/block] By default the donors are sent back to your embed url with a success parameter and the iFrame shows your success message of your form settings. There are several variables you can use to individualize the message. For more details please visit our [Help-Center](https://support.fundraisingbox.com/article/253.html). [block:image] { "images": [ { "image": [ "https://files.readme.io/19f10d8-FundraisingBox_Spendenformular-personalisierte-Erfolgsnachricht.png", "FundraisingBox_Spendenformular-personalisierte-Erfolgsnachricht.png", 630, 528, "#f0f1f0" ], "sizing": "original" } ] } [/block] [block:api-header] { "type": "basic", "title": "Own individual success URL" } [/block] If your FundraisingBox-plan includes this feature you can define your own success URL in your form settings. The donors will now be sent to this url after a successful donation. [block:image] { "images": [ { "image": [ "https://files.readme.io/a8855b0-FundraisingBox_spendenformular-einstellungen-eigene-erfolgsseite.png", "FundraisingBox_spendenformular-einstellungen-eigene-erfolgsseite.png", 629, 100, "#dce0d9" ], "sizing": "original" } ] } [/block] As you can see in the screenshot, you can append variables to your URL to individualize your success page: * %amount% * %salutation% * %title% * %first_name% * %last_name% * %company_name% * %country% * %fb_transaction_id% * %fb_project_id% * %fb_item_id% * %fb_type_id% * %interval% * %email% * %wants_newsletter% * %prepay_pay_text% * %prepay_due_date% * %prepay_bank_name% * %prepay_iban% * %prepay_bic% * %token% * %donation_custom\_field\_[ID]% * %person_custom\_field\_[ID]% **Examples:** ``` http://www.musterorganisation.de/danke.html?betrag=%amount%&anrede=%salutation%&vorname=%first_name%&nachname=%last_name% http://www.musterorganisation.de/danke.html?euro=%amount%&name=%first_name%%20%last_name%&projekt=%fb_item_id% http://www.musterorganisation.de/danke.html?amount=%amount%&tracking=%donation_custom_field_123% Append and use the token if you want to retrieve the transaction data via REST-API: http://www.musterorganisation.de/danke.html?token=%token% ``` **Some hints:** * If a company is the donor, only the %company_name% is set, but not %salutation%, %first_name% and %last_name%. * You can find the IDs of your custom fields at Settings > Custom fields. * %email%, %donation_custom_field_[ID]% and %person_custom_field_[ID]% are not available in all FundraisingBox-plans. * Please have a look on [Predefined values](doc:predefined-values) to see which values are possible. [block:api-header] { "type": "basic", "title": "Dynamic individual success URL" } [/block] If your FundraisingBox-plan includes the own individual success URL you can even use the [Form-Prepopulation-API](doc:form-prepopulation-api) to define a dynamic success URL. For example: if your donor comes from the project page "A" you can set the success URL to "thankyouA.html" and if your donor comes from the project page "B" you can define "thankyouB.html". The parameter to define the URL is "**success_redirect_url**". Of course you can also use the variables like %amount% etc. **Examples:** [block:code] { "codes": [ { "code": "http://www.myorga.com/donate.html?success_redirect_url=http://www.myorga.com/thankyou.html", "language": "text" } ] } [/block] [block:callout] { "type": "info", "title": "Append to Javascript / URL encoding", "body": "We recommend to append the URL encoded to the Javascript code, so it's not visible in the browser address line and there is no encoding mess up with the parameters." } [/block] [block:code] { "codes": [ { "code": "<script type=\"text/javascript\" src=\"https://secure.fundraisingbox.com/app/paymentJS?hash={your_form_hash}&success_redirect_url=http%3A%2F%2Fwww.myorga.com%2Fthankyou.html%3Famount%3D%25amount%25%26name%3D%25first_name%25\"></script>", "language": "html" } ] } [/block] [block:api-header] { "type": "basic", "title": "Automatic dynamic success URL" } [/block] If your FundraisingBox-plan has unlimited forms available, you can **embed a form anywhere you want**. The embed URL of your form settings is not checked anymore. **The form automatically remembers it's parent URL** and redirects to this URL after a successful donation. **Example:** Your embed URL in your form settings is just "http://www.myorga.com". Now you include your form to "http://www.myorga.com/donate.html" and the same form also to "http://www.myorga.com/membership.html". After a successful donation, the donors will be automatically sent to the origin with success-status: "http://www.myorga.com/donate.html?fbStatus=successful" and "http://www.myorga.com/membership.html?fbStatus=successful"