API Docs
Creating Payment Links
When creating payment links, you need to specify the amount and currency. This helps determine the payment details and ensures the correct amount is charged to the customer.
Headers
- Authorization:
Bearer YOUR_SECRET_KEY
- Content-Type:
application/json
Body Parameters
amount
Required - Amount to be charged (e.g., 100.00).
currency
Required - Currency code (e.g., USD, ZWG, ZAR).
Response Parameters
result
Status of the payment link creation.
payment_link_id
Payment Link ID.
hosted_payment_link
URL of the hosted payment link.
message
Message.
Sample Request to Create a Payment Link
1. Payment Link Creation Request
cURL
curl -X POST https://api.zuripay.app/v1/links \ -H "Authorization: Bearer zp_test_26PHem9AhJZvU623DfE1x4sd" \ -H "Content-Type: application/json" \ -d '{ "amount": "100.00", "currency": "USD" }'
Python
import requests url = https://api.zuripay.app/v1/links headers = { "Authorization": "Bearer zp_test_26PHem9AhJZvU623DfE1x4sd", "Content-Type": "application/json" } data = { "amount": "100.00", "currency": "USD" } response = requests.post(url, headers=headers, json=data) if response.status_code == 200: print("Payment link created:", response.json()) else: print("Error:", response.status_code, response.text)
Sample Responses
Successful Payment Link Creation (200)
{ "result": "success", "payment_link_id": "zp_link_1234567890", "hosted_payment_link": "https://checkout.zuripay.app/zp_link_1234567890", "message": "Payment link created successfully." }
Bad Request (400)
{ "result": "error", "message": "Invalid request parameters." }
Unauthorized (401)
{ "result": "error", "message": "Unauthorized. Please provide a valid API key." }
Internal Server Error (500)
{ "result": "error", "message": "Internal server error. Please try again later." }