POST /v1/gateway/payment/{id}/transition

POST
/v1/gateway/payment/{id}/transition

Authorization

headerApi-Key<token>

Path Parameters

id*string

Payment ID

Header Parameters

Api-Key?string|null
App-Id?string|null
Client-Id?string|null
WCP-Version?string|null
Sdk-Name?string|null
Sdk-Version?string|null
Sdk-Platform?string|null

Request Body

application/json
  1. body

Gateway sibling of [TestTransitionRequest]. Identical except the processing transition takes no wallet_id: the gateway is wallet-authenticated, so the wallet is derived from the request's credentials rather than supplied in the body.

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

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/gateway/payment/pay_7fa2ecc101ARZ3NDEKTSV4RRFFQ69G5FAV/transition' \  -H 'Content-Type: application/json' \  -d '{  "buyer_caip10": "string",  "option_id": "string",  "status": "processing"}'
{  "paymentId": "pay_7fa2ecc101ARZ3NDEKTSV4RRFFQ69G5FAV",  "status": "requires_action"}