Quick Start
1Get Your API Credentials
Apply to become a partner and receive your API key. Once approved, you'll get access to:
- Production API key
- Sandbox API key for testing
- Webhook secret for event verification
2Configure Authentication
Include your API key in all requests using the Authorization: Bearer header:
curl -X POST "https://divinitycoin.com/internal?action=validate" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"code": "XXXX-XXXX-XXXX-XXXX", "platformUserId": "user123"}'3Implement Credit Redemption
When a user wants to add credits, call the validation endpoint:
POST /internal?action=validate
{
"code": "XXXX-XXXX-XXXX-XXXX",
"platformUserId": "your-platform-user-id"
}
Response:
{
"success": true,
"amount": 25.00,
"newBalance": 50.00
}Complete Money Flow
USER DIVINITYCOIN PARTNER CREATOR │ │ │ │ │ 1. Buys $100 credits │ │ │ │───────────────────────►│ │ │ │ │ │ │ │ (Stripe processes) │ │ │ │ │ Funds held │ │ │ │ │ │ │ 2. Redeems code │ │ │ │────────────────────────┼───────────────────►│ │ │ │ (validates) │ │ │ │◄──────────────────►│ │ │ │ │ │ │ 3. Backs project │ │ │ │────────────────────────┼───────────────────►│ │ │ │ (hold placed) │ │ │ │◄──────────────────►│ │ │ │ │ │ │ │ │ 4. Project funds │ │ │ (capture hold) │ │ │ │◄──────────────────►│ │ │ │ │ Creator earned │ │ │ │ $100 in credits │ │ │ │──────────────────►│ │ │ │ │ │ │ 5. Settlement │ │ │ │ (weekly/monthly) │ │ │ │───────────────────►│ │ │ │ Wire $94 (net) │ │ │ │ (after 6% fee) │ │ │ │ │ │ │ │ │ 6. Creator payout │ │ │ │ (Stripe Connect) │ │ │ │───────────────────►│ │ │ │ $89.30 │ │ │ │ (after 5% fee) │
Fee Structure
DivinityCoin charges a 6% total partner fee on all settled credits.
| Stage | Fee | Who Pays | Example ($100) |
|---|---|---|---|
| Total Partner Fee | 6% | Partner | $6.00 |
| └ Stripe Processing | ~2.9% + $0.30 | (included) | ~$3.20 |
| └ Platform Fee | ~2.8% | (included) | ~$2.80 |
| Partner Platform Fee | 5% of earnings | Creator | $94 × 5% = $4.70 |
| Stripe Connect Payout | ~0.25% | Creator | ~$0.25 |
| Creator Receives | ~$89.05 |
API Configuration
Base URL
https://divinitycoin.comAuthentication
All API requests require a Bearer token in the Authorization header:
Authorization: Bearer YOUR_API_KEY
Request Format
All endpoints use query parameters for the action type:
POST /internal?action=validate POST /internal?action=balance POST /internal?action=hold POST /internal?action=capture POST /internal?action=release GET /internal?action=health GET /internal?action=settlements&partnerId=xxx GET /internal?action=captures&partnerId=xxx