Verify or recover a hosted IDR payment
Checks the payment provider for the status of your existing Doit top-up.
Access: API key: billing:write · Session: any role, own account.
- Reuses the original invoice and request identity, including after an uncertain checkout. Switching gateways does not replace pending payments.
- A short cooldown limits repeated checks. Existing payments can settle while new top-ups are paused, but paused funding cannot create another checkout.
- Other users receive
404, including workspace owners.
AuthorizationBearer <token>Send Authorization: Bearer <token>. A token is an API key (lb_live_…, scoped, for programs) or a session (lb_sess_…, from signup or login, for people). See Authentication above.
id*stringThe resource id.
X-Org-ID?stringSessions only: act on this organization (you must be a member). Default: your first organization.
Original personal payment after verification or checkout recovery.
application/json- response
credit?display_idr_per_usd?stringImmutable original rate for displaying this USD credit in IDR. Omitted on legacy instructions or when unconfigured.
^[0-9]+$instructions_version?1Immutable instruction snapshot version; legacy rows may omit it.
1id*stringpurpose*stringNew intents are top-ups. The legacy vm_purchase value remains readable for historical records.
"vm_purchase""topup"method*stringusdc_tempo is used only by MPP agent top-ups.
"usdc_solana""usdc_arc""usdc_tempo"status*stringawaiting: nothing received. partial: some received. paid: complete. expired/canceled: closed (anything received is wallet balance).
"awaiting""partial""paid""expired""canceled"vm_id*|Null for new top-ups; retained only for historical direct-payment VM orders.
amount*received*What has arrived so far.
pay_to*stringThe address to pay on the stated network.
reference*|Solana only: a unique reference key that identifies this payment (already inside payment_uri).
payment_uri*stringA link/QR payload for wallets: Solana Pay on Solana, an EIP-681 request on Arc.
network*expires_at*stringPay before this time.
date-timepaid_at*|date-timecreated_at*stringdate-timetransactions*array<>On-chain transfers credited to this payment, oldest first. Empty until a transfer is credited.
curl -X POST 'https://layerbeat.com/v1/billing/payments/string/refresh'{ "credit": { "currency": "IDR", "amount": "80001" }, "display_idr_per_usd": "16000", "instructions_version": 1, "id": "pay_h3x9k2m7q4w6z8tfjn5r2bcdva", "purpose": "topup", "method": "usdc_solana", "status": "awaiting", "vm_id": "vm_gnkrp6zuxvsqki7sqxeluvsw2y", "amount": { "usd": "12.00", "usdc": "12.003417" }, "received": { "usdc": "0.000000", "credited_usd": "12.00" }, "pay_to": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU", "reference": "J4Zq…", "payment_uri": "solana:7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU?amount=12.003417&spl-token=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&reference=J4Zq…&label=VPS", "network": { "name": "USDC on Solana", "network": "solana", "asset": "USDC", "contract": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "genesis_hash": "5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d", "token_account": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU", "token_program": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA", "decimals": 6 }, "expires_at": "2026-10-01T11:00:00Z", "paid_at": "2019-08-24T14:15:22Z", "created_at": "2026-10-01T10:00:00Z", "transactions": [ { "id": "5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW", "explorer_url": "https://solscan.io/tx/5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW" } ]}