Toggle Payment Link Status

Toggle Payment Link Status

Activate or deactivate a payment link for the authenticated business.

URL: https://atlas.tryduplo.com

Method: POST

Endpoint: /api/v1/payment-link/toggle-status

Authorization

Type: Bearer Auth
Header:
Authorization: Bearer <token>

Request Body

Content-Type: application/json 

{
  "link_id": "string",
  "activate": true
}

Response Body

Success Response (200)

{
  "requestId": "abcd1234-5678-90ef-ghij-1234567890kl",
  "requestTimestamp": "2026-03-25 09:15:00",
  "message": "Payment link status updated successfully.",
  "statusCode": 200,
  "data": {
    "id": "019a1639-ce25-70b7-ab20-16fcb2bac023",
    "createdAt": "2026-03-25 09:15:00",
    "linkName": "Invoice payment",
    "linkUrl": "https://app.example.com/pay/PLK_ABC123456",
    "amount": 5000,
    "status": "Active",
    "narration": "Payment for March invoice",
    "businessState": "live",
    "reference": "PLK_ABC123456",
    "sourceReference": "SRC_PLK_001",
    "feeBearer": "MERCHANT"
  }
}

Error Responses

Example cURL Request

curl -X POST "https://atlas.tryduplo.com/api/v1/payment-link/toggle-status" \ 
  -H "Authorization: Bearer <token>" \ 
  -H "Content-Type: application/json" \ 
  -d '{"link_id": "019a1639-ce25-70b7-ab20-16fcb2bac023", "activate": true}'

How is this guide?
Good / Bad

Last updated on 5/27/2026