> For the complete documentation index, see [llms.txt](https://docs.papelship.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.papelship.com/api-based-store/payment-status.md).

# Payment Status

Real-time payment status and blockchain confirmation check API

## Check Real-time Payment & Confirmation Status

> Verifies real-time status, paid timestamp, payment method, block confirmations, transaction hash, and return URL status.

```json
{"openapi":"3.0.3","info":{"title":"PapelShip API Gateway","version":"1.0.0"},"tags":[{"name":"Payment Status","description":"Real-time payment status and blockchain confirmation check API"}],"servers":[{"url":"https://papelship.com","description":"Production API Server"}],"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API-Key","description":"Pass your secret API key formatted as: `Authorization: Bearer psa_...`"},"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Alternative header format: `X-API-Key: psa_...`"}}},"paths":{"/api/api-store/v1/payment-links/check":{"get":{"summary":"Check Real-time Payment & Confirmation Status","description":"Verifies real-time status, paid timestamp, payment method, block confirmations, transaction hash, and return URL status.","operationId":"checkPaymentStatus","tags":["Payment Status"],"parameters":[{"name":"invoiceId","in":"query","required":true,"description":"The unique invoice ID string","schema":{"type":"string"}}],"responses":{"200":{"404":{"description":"Invoice Not Found"},"description":"Real-time payment status and blockchain confirmation details","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"payment":{"type":"object","properties":{"invoice_id":{"type":"string"},"status":{"type":"string"},"is_paid":{"type":"boolean"},"amount":{"type":"number"},"currency":{"type":"string"},"payment_method":{"type":"string"},"customer_email":{"type":"string"},"redirect_url":{"type":"string"},"paid_at":{"type":"string","format":"date-time"},"created_at":{"type":"string","format":"date-time"},"expires_at":{"type":"string","format":"date-time"},"crypto_details":{"type":"object","properties":{"coin":{"type":"string"},"network":{"type":"string"},"address":{"type":"string"},"crypto_amount":{"type":"number"},"confirmations":{"type":"integer"},"required_confirmations":{"type":"integer"},"tx_hash":{"type":"string"}}}}}}}}}}}}}}}
```