POST /v1/payments/{id}/transition

POST
/v1/payments/{id}/transition

Authorization

headerApi-Key<token>

Path Parameters

id*string

Payment ID

Header Parameters

Api-Key*string
Merchant-Id*string
WCP-Version?string|null
Sdk-Name?string|null
Sdk-Version?string|null
Sdk-Platform?string|null
Idempotency-Key?string|null

Request Body

application/json
  1. body

Commit the payment to processing. The option_id selects a server-stored option; method and chain are derived from it. No signature, hash, or relayer enqueue — test processing does no on-chain work.

buyer_caip10*string
option_id*string
status*"processing"
Value in"processing"
wallet_id*string

Response Body

Payment transitioned

application/json
  1. response
paymentId*PaymentId

Payment ID

status*PaymentStatus

Payment status representing the lifecycle of a payment.

Payments progress through these states from creation to terminal status. Some states are specific to the payment source (pull vs push).

Value in"requires_action""processing""succeeded""failed""expired""cancelled"
curl -X POST 'https://api.pay.walletconnect.com/v1/payments/pay_7fa2ecc101ARZ3NDEKTSV4RRFFQ69G5FAV/transition' \  -H 'Api-Key: string' \  -H 'Merchant-Id: string' \  -H 'Content-Type: application/json' \  -d '{  "buyer_caip10": "string",  "option_id": "string",  "status": "processing",  "wallet_id": "string"}'
{  "paymentId": "pay_7fa2ecc101ARZ3NDEKTSV4RRFFQ69G5FAV",  "status": "requires_action"}