API ReferenceVerification

Verdict for an agent payment

GET
/api/verify/{paypalOrderId}

Is this PayPal order backed by a mandate the buyer signed? Returns the Mandate v1 checks (Intent, Cart and Payment Mandates, Ed25519), the paypal_order_record check (PayPal's own order record, read with the PayPal Server SDK, shows the signed amount captured), and the AP2 v0.2 verdict in ap2. Fulfil only when ok and ap2.ok are both true.

Path Parameters

paypalOrderId*string

PayPal order ID (sandbox), or SIM-… in offline mode.

Response Body

application/json

application/json

curl -X GET "https://example.com/api/verify/string"
{  "ok": true,  "checks": [    {      "id": "string",      "label": "string",      "ok": true,      "detail": "string"    }  ],  "notes": [    "string"  ],  "paypalOrderId": "string",  "paymentMandateId": "string",  "mode": "human_not_present",  "merchant": "string",  "total": "string",  "items": [    "string"  ],  "createdAt": "2019-08-24T14:15:22Z",  "chain": {    "intent": {},    "cart": {},    "payment": {}  },  "ap2": {    "spec": "ap2/0.2",    "paypalOrderId": "string",    "ok": true,    "mode": "human_not_present",    "checks": [      {        "id": "string",        "label": "string",        "ok": true,        "detail": "string"      }    ],    "amount": {      "amount": 0,      "currency": "string"    },    "merchant": {      "id": "string",      "name": "string"    },    "evidence": {      "spec": "ap2/0.2",      "mode": "string",      "checkoutJwt": "string",      "checkoutChain": "string",      "paymentChain": "string",      "context": {        "totalAmount": 0,        "totalUses": 0      },      "checkoutReceipt": "string",      "paymentReceipt": "string",      "openCheckoutHash": "string",      "passkey": {}    }  }}