Subscriptions

Check payment status

POST/api/v1/subscriptions/payments/:depositId/check-status

Polls PawaPay for a deposit's current status and, if it has resolved, updates the subscription accordingly — a fallback for when the webhook hasn't landed yet.

Requires Authorization

SELLER only

Payment

Path parameters

depositIdstringrequired

Must belong to the signed-in seller.

Request

curl --request POST \
  --url https://api.swiftgoma.com/api/v1/subscriptions/payments/:depositId/check-status \
  --header 'Authorization: Bearer <access_token>'

200Example response

{
  "success": true,
  "data": {
    "subscription": {
      "id": "sub_9c8d7e",
      "sellerProfileId": "sp_2b3c4d",
      "planId": "plan_starter",
      "billingCycle": "MONTHLY",
      "currency": "USD",
      "status": "ACTIVE",
      "currentPeriodStart": "2026-02-01T00:00:00.000Z",
      "currentPeriodEnd": "2026-03-01T00:00:00.000Z"
    },
    "payment": {
      "id": "subpay_1a2b3c",
      "subscriptionId": "sub_9c8d7e",
      "depositId": "SWG-DEP-9f8e7d6c5b4a3210",
      "amount": "10.00",
      "currency": "USD",
      "status": "SUCCEEDED",
      "paidAt": "2026-02-01T09:05:00.000Z"
    },
    "pawapayStatus": "COMPLETED"
  }
}