Developer Workflow
Create a payment link by API
Send amount, token, title, and metadata. GoPaySol returns a hosted checkout URL.
Buyer pays on hosted checkout
Your customer completes payment through the GoPaySol payment page.
GoPaySol verifies on-chain
GoPaySol validates recipient, token, amount, reference, and transaction success.
Receive payment.paid webhook
Your app receives a signed webhook after payment is confirmed.
Unlock your product or service
Use the webhook to update your system, unlock access, or mark an order as paid.
Sample API Preview
A simple POST request creates a fully hosted checkout session that you can immediately redirect your users to.
curl -X POST https://api.gopaysol.com/v1/payment-links \
-H "Authorization: Bearer GPS_TEST_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: order_12345" \
-d '{
"title": "Website Design Advance Payment",
"amount": "25.00",
"token": "USDC",
"environment": "test",
"customer_reference": "customer_456",
"metadata": {
"order_id": "ORD-1001"
}
}'Developer Principles
Hosted checkout first
Hosted payment pages provide a safer and more compatible starting point for wallet payments.
Webhooks are the source of truth
Frontend success messages should not be used for fulfillment. Your backend should wait for signed webhook confirmation.
Test before live
Use Test Mode before sending real payment links to customers.
Idempotency matters
Webhook events may be retried. Your system should process event IDs safely.