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."
}