Intent Endpoints

Get Intent

Retrieve the current status and details of a payment intent.

GET https://testnetv1.ababilpay.xyz/api/v1/x402/intents/{intent_id}
Authorization: Bearer sk_test_...

Intent Status Values

Status	Description
`pending`	Created and awaiting payment. Expires after 30 minutes.
`paid`	Fully settled on-chain.
`expired`	Not paid within the 30-minute window.
`cancelled`	Cancelled by the merchant before settlement.

Paid Intent Response

{
  "success": true,
  "data": {
    "intent_id":     "d03e0751-5a79-4b33-aa0e-d33dee344f27",
    "status":        "paid",
    "amount_usdc":   29.99,
    "order_id":      "order_8821",
    "tx_hash":       "0xf4753b209212ece119cb099f8f499efb6a4df031...",
    "buyer_address": "0xBuyerAddress",
    "chain":         "eip155:84532",
    "paid_at":       "2026-05-25T12:05:00Z",
    "expires_at":    "2026-05-25T13:00:00Z"
  }
}

Poll interval: Every 3–5 seconds. Settlement is typically 1–10 seconds depending on chain.

List Intents

Retrieve a paginated list of payment intents for the authenticated merchant.

GET https://testnetv1.ababilpay.xyz/api/v1/x402/intents
Authorization: Bearer sk_test_...

Query Parameters

Parameter	Type	Description
`status`	string	Filter by intent status: `pending`, `paid`, `expired`, `cancelled`.
`order_id`	string	Filter by your internal order reference.
`limit`	integer	Number of results to return. Max `100`, default `20`.
`offset`	integer	Pagination offset. Default `0`.

GET /api/v1/x402/intents?status=paid&limit=50&offset=0

Response `200`

{
  "success": true,
  "data": {
    "intents": [ /* array of intent objects */ ],
    "total":  142,
    "limit":  50,
    "offset": 0
  }
}

Cancel Intent

Cancel a pending payment intent. Only intents with status: "pending" can be cancelled.

DELETE https://testnetv1.ababilpay.xyz/api/v1/x402/intents/{intent_id}
Authorization: Bearer sk_test_...

Returns 404 if the intent is already paid or expired.

Response `200`

{
  "success": true,
  "data": {
    "intent_id": "d03e0751-5a79-4b33-aa0e-d33dee344f27",
    "status":    "cancelled"
  }
}

Cancelling an intent does not issue a refund — it simply prevents further payment attempts. If a buyer has already signed an authorization but settlement hasn’t been submitted yet, cancellation will block that submission.

Overview

Integration paths

Endpoints

AI agents

Reference

Get Intent

Intent Status Values

Paid Intent Response

List Intents

Query Parameters

Response `200`

Cancel Intent

Response `200`

​Get Intent

​Intent Status Values

​Paid Intent Response

​List Intents

​Query Parameters

​Response 200

​Cancel Intent

​Response 200

Get Intent

Intent Status Values

Paid Intent Response

List Intents

Query Parameters

Response `200`

Cancel Intent

Response `200`