Skip to main content
Look up a payment by its checkout_id (the id returned when you created the checkout). Returns one of pending, completed, failed, or refunded. 
curl --request GET \
  --url https://api.privexpay.com/api-payments/b3f1c2d4-7e8a-4d2b-9f1c-1234567890ab \
  --header 'x-api-key: pp_live_your_api_key'

const response = await fetch('https://api.privexpay.com/api-payments/b3f1c2d4-7e8a-4d2b-9f1c-1234567890ab', {
  headers: { 'x-api-key': 'pp_live_your_api_key' },
});
const { data } = await response.json();
console.log(data.payment_status); // 'completed', 'pending', 'failed', 'refunded'
Example Response: 
{
  "data": {
    "checkout_id": "b3f1c2d4-7e8a-4d2b-9f1c-1234567890ab",
    "payment_status": "completed",
    "amount": 69.97,
    "currency": "USD",
    "created_at": "2026-05-11T12:00:00Z"
  }
}