Get Credit Top-up
Check whether a top-up has been paid and credited at /api/v1/credits/topups/
Overview
Returns a top-up’s checkoutstatus and whether it has been credited. This is the read behind morph billing topup-status. Each call re-reads the checkout from Coinbase and credits the balance as soon as the payment settles, so there is no need to wait for a webhook.
Gate on credited. FAILED, EXPIRED and DEACTIVATED are terminal and unpaid: create a new top-up. While the checkout is still ACTIVE, x402_url is returned again so a retry can pay it.Authorizations
Morph API key, passed as Authorization: Bearer sk-.... Create keys at https://www.morphllm.com/dashboard/api-keys.
Path Parameters
Identifies the top-up to read. Checkout id returned when the top-up was created.
^[0-9a-f]{24}$"6ae3c4f9b78e569c621631be"
Response
The top-up state.
Current state of a top-up.
Checkout id.
"6ae3c4f9b78e569c621631be"
Coinbase checkout status. ACTIVE accepts payment at x402_url; PROCESSING means capture is under way; COMPLETED means settled. FAILED, EXPIRED and DEACTIVATED are terminal and unpaid, so start a new top-up. A completed top-up can later become REFUNDED or PARTIALLY_REFUNDED.
ACTIVE, PROCESSING, COMPLETED, FAILED, EXPIRED, DEACTIVATED, REFUNDED, PARTIALLY_REFUNDED "ACTIVE"
USD amount of the top-up, two decimals.
"25.00"
Currency the top-up settles in.
USDC "USDC"
True once the amount has been added to the balance. Gate on this.
true
On-chain capture transaction on Base, once settled.
"0x8f5c0e5b8d1f6a3c9e2b7d4a1f0c3e6b9a2d5f8c1e4b7a0d3f6c9e2b5a8d1f4c"
Payment URL while the checkout is still ACTIVE and unpaid; null otherwise.
null