APG PayAPG Paydocs

Payment sources

Update source verification

PATCH/source-verifications/{sourceVerificationId}

Override a verification's outcome, pass it, fail it, or reset it to run again.

Permissions

Required permission
sourceVerifications:update

Requires the `update` action on `sourceVerifications` for the supplied runtime context

Path parameters

sourceVerificationIdstring
required

Request body

This body is a tagged shape: type is always "PsrcverUpdateAttributes". Send it; more variants can be added, and a caller that switches on it keeps working when they are.

Discriminated by type
type = "PsrcverUpdateAttributes"
statusPsrcverStatus

Passed passes the check, Failed fails it, Pending resets it to be confirmed again.

PendingPassedFailedExpiredUnknown
curl -X PATCH https://api.tst.au.apgpay.dev/source-verifications/{sourceVerificationId} \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "PsrcverUpdateAttributes",
  "status": "Pending"
}'

Responses

The response is a tagged shape: type is always "PsrcverUpdateRspAttributes". Switch on it; subtypes can be added, and a client that already reads it will not break.

Discriminated by type
type = "PsrcverUpdateRspAttributes"

The resource as it stands after the change.

Example
{
  "type": "PsrcverUpdateRspAttributes",
  "updated": {
    "type": "PsrcverViewAttributes",
    "sourceVerificationId": "psrcver_9f2Kd8QpLzXw",
    "sourceReference": "your-own-reference",
    "status": "Pending",
    "chargedAmount": {
      "type": "IsoCurrencyAmount",
      "minorCurrencyUnits": 1250,
      "currency": "AUD"
    },
    "createdAt": "2026-08-19T04:21:07Z",
    "updatedAt": "2026-08-19T04:21:07Z"
  }
}

Error responses