UNICEF UK payment gateway
All projects on 50/50 have their own UNICEF donation payment gateway which helps us track donations to your project. This allows us to include your donations in the 50/50 total, and make data associated with them available to your web service via our API.
This payment gateway is for use with UK based donors; it defaults to payment in GBP and will handle gift aid donations, there is a similar gateway for use by projects based in the US.
UNICEF can not accept donations of less than £2.00 per transaction due to the cost of administration fees.
Customisation
Projects' payment gateways have two URLs: A short URL, which can not be customised but is useful for promoting yourself on social networking sites; and a long URL which can have the below parameters appended to it to provide bespoke functionality.
You will be provided these when you initially set up your project; they will take the format:
https://fundraise.unicef.org.uk/Donate/ToEvent/e0d4ef9d-985d-4ea8-9d25-9f480084f22d?project_id=[project_id]
http://5050.gd/dn[project_id]
‘return_url’ URL parameter
If you wish to customise your users' journey to have them return to a page other than the project's 50/50 campaign page, you may do so by appending a return_url parameter to your long donation URL:
https://fundraise.unicef.org.uk/Donate/ToEvent/e0d4ef9d-985d-4ea8-9d25-9f480084f22d?project_id=[project_id]&return_url=http://www.example.com/
‘data’ URL parameter
You may pass an arbitrary string through the UNICEF donation handling system by specifying the data parameter. This parameter will be stored with the donation in the 50/50 database and accessible via our API to help you track donations.
This parameter can be a maximum of 250 characters in length and should be URL encoded.
https://fundraise.unicef.org.uk/Donate/ToEvent/e0d4ef9d-985d-4ea8-9d25-9f480084f22d?project_id=[project_id]&data=store_this_with_donation
‘amount’ URL parameter
If your site has determined how much a user wishes to donate before they are directed to the payment gateway you may pass the amount parameter. The user will be able to adjust this amount once they are on the payment page.
This amount should be passed in GBP, unless the currency parameter is also specified.
https://fundraise.unicef.org.uk/Donate/ToEvent/e0d4ef9d-985d-4ea8-9d25-9f480084f22d?amount=5
‘currency’ URL parameter
Change the default currency used for this payment. Available options are: USD, GBP or EUR.
https://fundraise.unicef.org.uk/Donate/ToEvent/e0d4ef9d-985d-4ea8-9d25-9f480084f22d?currency=USD