Staging environment access

Staging environment: https://public-api.tgb-preprod.com

Please contact integrations@thegivingblock.com 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 integrations@thegivingblock.com 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 integrations@thegivingblock.com 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 integrations@thegivingblock.com 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 integrations@thegivingblock.com to approve donation on The Giving Block side.
Await for webhook notifications. See details here: Webhook notifications