Confirm & Release
Releases locked vault funds to the seller after the buyer validates goods delivery or enters PIN authorization.
Request Headers
| Header | Type | Status | Description |
|---|---|---|---|
Authorization | string | Required | Bearer vxz_tok_* (OAuth 2.0 Scoped Bearer Token) |
Content-Type | string | Required | application/json |
Idempotency-Key | string | Recommended | Unique key for this operation, 8–80 characters. Send it to make retries safe: repeating the same key returns the original result instead of performing the operation twice. Without it the API derives a key from the request body and replays the original result for a few minutes, so an accidental double submit is still ignored. |
POST/v1/p2p/orders/confirmLive & Sandbox
Body Parameters (JSON)
| Parameter | Type | Status | Description |
|---|---|---|---|
vaultReference | string | Required | Reference returned by Create Vault |
transactionPin | string | Required | RSA-OAEP encrypted seller PIN |
Request Code Snippets (cURL, Node, Python, PHP, Go)
Request Example
curl -X POST https://developer.vixzz.com/v1/p2p/orders/confirm \
-H "Authorization: Bearer vxz_tok_c2b_8f9k3m9s2a1l" \
-H "Content-Type: application/json" \
-d '{
"orderId": "ESC_VXZ_749201",
"releaseCode": "REL_VXZ_SHA256_8819",
"actorRole": "buyer",
"encryptedPin": "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA3f9..."
}'JSON Return Response Body (200 OK)
Response
{
"success": true,
"orderId": "ESC_VXZ_749201",
"status": "RELEASED",
"releasedAmount": 120000,
"completedAt": "2026-09-07T02:30:00.164Z"
}