Here we describe how to test your integration using our staging environment
Staging environment access
Staging environment: https://public-api.tgb-preprod.com
Please contact [email protected] to get API credentials to Staging environment.
Note, that to make test Crypto and Card donations in the Staging environment you should use real crypto networks and real cards, so you can test everything end-to-end.
For testing Stock donations you don't need to make a real transfer of stocks.
Testing embedded donation form
- Make sure you get access to staging environment https://public-api.tgb-preprod.com
- Follow Embedded donation form guide to build your integration
- Since you are using The Giving Block donation form you can rely on testing which was performed by our quality assurance team. So you don't need to test real crypto and card payments
Testing native integration
- Make sure you get access to staging environment https://public-api.tgb-preprod.com
- Follow the guides to implement your native integration for desired donation methods:
How to test Crypto donations
Note, that to make test Crypto donations in the Staging environment you should use real crypto networks, so you can test everything end-to-end.
- If not yet done, then create test organization in Staging environment. There are 2 ways to do it:
- Manually: contact [email protected] to configure new organization in The Giving Block system and enable accepting of Crypto donations
- Automatically using API: follow onboarding guide to perform onboarding for Crypto Donations
- Use real crypto to send a donation. Make sure that donation amount is above the minimum: https://support.gemini.com/hc/en-us/articles/4401824250267-Does-Gemini-have-trading-minimums###
- Await for webhook notifications. See details here: Webhook notifications
How to test Card donations
Note, that to make test Card donations in the Staging environment you should use real credit or debit card, so you can test everything end-to-end. Due to test merchant configuration card donation may fail for some of card types.
- If not yet done, then create test organization in Staging environment. There are 2 ways to do it:
- Manually: contact [email protected] to configure new organization in The Giving Block system and enable accepting of Card donations
- Automatically using API: follow onboarding guide to perform onboarding for Card Donations
- Make a card donation.
- Await for webhook notifications. See details here: Webhook notifications
How to test Stock donations
For testing stock donation please follow these steps:
- If not yet done, then create test organization in Staging environment. There are 2 ways to do it:
- Manually: contact [email protected] to configure new organization in The Giving Block system and enable accepting of Stock donations
- Automatically using API: follow onboarding guide to perform onboarding for Stock Donations
- Make a stack donation pledge using your donation form, fill out all required information.
- Contact [email protected] to approve donation on The Giving Block side.
- Await for webhook notifications. See details here: Webhook notifications