Revoke billing readiness

POST /api/v2/storefront/account-mappings/ready-to-invoice/{assertionId}/revoke The reverse of asserting billing readiness, and it fails closed: it immediately blocks new direct-billed activity on the account (any active grant billed to this party moves to payment_required), without touching buys already placed. It never falls back to agent/Interchange billing on your behalf — that would put someone else on the hook for an invoice you decided to send yourself.

Request

curl -X POST https://api.interchange.io/api/v2/storefront/account-mappings/ready-to-invoice/331/revoke \
  -H "Authorization: Bearer $SCOPE3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "reason": "Payment method declined; account moved to collections." }'

Parameters

Field	Type	Required	Notes
`assertionId`	string (path)	Yes	The assertion id from the assert response, from the review queue’s `billingGate` (while the intake is still pending), or from recovering it once the account has already activated.
`reason`	string	Yes	1–500 characters. Recorded on the assertion’s audit trail.

Response

200 OK with the revoked assertion (state: "revoked"), in the same shape as the assert response.

Errors

400 VALIDATION_ERROR — reason is missing, empty, or too long.
401 UNAUTHORIZED — missing or invalid API key.
404 NOT_FOUND — no active assertion with this id under your storefront. An already-revoked assertion 404s the same way.

See Errors for the full error contract.

Assert billing readiness

Confirm a direct-billed buyer is billable

Recover a billing-readiness assertion

Find the assertion id for an account that’s already active

Buyer Account Mapping

The review queue, whose billingGate field reflects this state

Start here

Buy media

Sell media

Help and updates

Revoke billing readiness

Request

Parameters

Response

Errors

Assert billing readiness

Recover a billing-readiness assertion

Buyer Account Mapping

​Request

​Parameters

​Response

​Errors

​Related

Assert billing readiness

Recover a billing-readiness assertion

Buyer Account Mapping

Request

Parameters

Response

Errors

Related