Confirm buyer information

POST /api/v2/storefront/account-mappings/information-requests/{requestId}/confirm The buyer opening your launch link is not proof that anything arrived — a person can open a link and never submit the form behind it. This call is your explicit statement that the requested material showed up in your process (the completed form, the signed contract, the reply email). It is the only thing that unblocks the case. Once confirmed, the account-setup case returns to your review queue with blockedOnParty: null, and you decide it the same way you decide any other pending request — accept, link to an existing account, or reject.

Request

curl -X POST https://api.interchange.io/api/v2/storefront/account-mappings/information-requests/9931/confirm \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

Parameters

Field	Type	Required	Notes
`requestId`	string (path)	Yes	The information request’s `id`, from the `request-information` response or the pending request on a review row.

Response

200 OK with the confirmed request:

{
  "id": "9931",
  "caseId": "4821",
  "status": "confirmed",
  "message": "Please send your completed W-9 and a signed insertion order to finish setup.",
  "destinationUrl": "https://forms.example-seller.com/onboarding/w9",
  "url": "https://api.interchange.io/seller/acme-storefront/mcp/handoffs/kx9F2...",
  "expiresAt": "2026-09-15T00:00:00.000Z",
  "createdBy": "ops@example-seller.com",
  "confirmedBy": "ops@example-seller.com",
  "confirmedAt": "2026-08-26T09:14:03.000Z",
  "createdAt": "2026-08-25T14:02:11.000Z"
}

Errors

401 UNAUTHORIZED — missing or invalid API key.
404 NOT_FOUND — no pending information request with this id under your storefront (already confirmed, superseded, or never existed).

See Errors for the full error contract.

Request buyer information

Ask for information in the first place

Buyer Account Mapping

The review queue this case comes from

Start here

Buy media

Sell media

Help and updates

Confirm buyer information

Request

Parameters

Response

Errors

Request buyer information

Buyer Account Mapping

​Request

​Parameters

​Response

​Errors

​Related

Request buyer information

Buyer Account Mapping

Request

Parameters

Response

Errors

Related