Get Payment Result

curl "https://sandbox.api.prava.space/v1/sessions/sess_123/payment-result" \
  -H "Authorization: Bearer sk_test_..."

import requests

resp = requests.get(
    "https://sandbox.api.prava.space/v1/sessions/sess_123/payment-result",
    headers={"Authorization": "Bearer sk_test_..."},
)

const resp = await fetch("https://sandbox.api.prava.space/v1/sessions/sess_123/payment-result", {
  headers: {
    Authorization: "Bearer sk_test_...",
  },
});

{
  "session_id": "sess_123",
  "order_id": "ord_4a1b",
  "status": "awaiting_result",
  "transactions": [
    {
      "txn_id": "txn_1",
      "card_id": "card_42",
      "status": "awaiting_result",
      "line_items": [
        {
          "txn_ref_id": "tli_1",
          "merchant_name": "Acme Store",
          "total_amount": "49.99",
          "status": "credentials_generated",
          "token": "4111111111111111",
          "dynamic_cvv": "123",
          "expiry_month": "12",
          "expiry_year": "2030",
          "products": []
        }
      ]
    }
  ]
}

{
  "session_id": "sess_123",
  "order_id": "ord_4a1b",
  "status": "processing",
  "transactions": [
    {
      "txn_id": "txn_1",
      "card_id": "card_42",
      "status": "awaiting_result"
    }
  ],
  "merchant_res": {
    "status": "prepared"
  }
}

{
  "error": { "code": "AUTH_1002", "message": "Missing or invalid Authorization header" }
}

{
  "error": { "code": "NOT_FOUND", "message": "Session not found" }
}

GET

sessions

{sessionId}

payment-result

curl "https://sandbox.api.prava.space/v1/sessions/sess_123/payment-result" \
  -H "Authorization: Bearer sk_test_..."

import requests

resp = requests.get(
    "https://sandbox.api.prava.space/v1/sessions/sess_123/payment-result",
    headers={"Authorization": "Bearer sk_test_..."},
)

const resp = await fetch("https://sandbox.api.prava.space/v1/sessions/sess_123/payment-result", {
  headers: {
    Authorization: "Bearer sk_test_...",
  },
});

{
  "session_id": "sess_123",
  "order_id": "ord_4a1b",
  "status": "awaiting_result",
  "transactions": [
    {
      "txn_id": "txn_1",
      "card_id": "card_42",
      "status": "awaiting_result",
      "line_items": [
        {
          "txn_ref_id": "tli_1",
          "merchant_name": "Acme Store",
          "total_amount": "49.99",
          "status": "credentials_generated",
          "token": "4111111111111111",
          "dynamic_cvv": "123",
          "expiry_month": "12",
          "expiry_year": "2030",
          "products": []
        }
      ]
    }
  ]
}

{
  "session_id": "sess_123",
  "order_id": "ord_4a1b",
  "status": "processing",
  "transactions": [
    {
      "txn_id": "txn_1",
      "card_id": "card_42",
      "status": "awaiting_result"
    }
  ],
  "merchant_res": {
    "status": "prepared"
  }
}

{
  "error": { "code": "AUTH_1002", "message": "Missing or invalid Authorization header" }
}

{
  "error": { "code": "NOT_FOUND", "message": "Session not found" }
}

A polling endpoint: after the cardholder completes card entry and passkey approval on Prava’s secure surface, poll it to read the outcome and, for non-quote checkouts, the single-use credentials. GET /v1/sessions/{sessionId}/payment-result · Authenticated with your secret key.

Path parameters

string

required

The session id from Create Session.

Response

string

string | null

string

Overall session status: pending, processing, awaiting_result, completed, or failed. processing means authentication or tokenization is in flight, or a quote-backed merchant checkout is not yet terminal.

object[]

Show transaction properties

string

string | null

The card bound to this transaction—the source of truth whether it was preselected or selected or entered on the collection surface. null when no card is bound.

string

initiated | awaiting_result | completed | failed.

object[]

Omitted from credential-free quote-backed results.

Show line_item properties

string

Line-item reference — pass this to Report Status.

string | null

string

pending | credentials_generated | completed | failed.

string | null

Virtual card number (network token) your agent uses at checkout. Non-null after credentials are generated.

string | null

Single-use CVV. Non-null after credentials are generated.

string | null

object[]

Show product properties

string

string | null

string

number

object

Present only when the transaction failed: { code, message }.

object

Present only for quote-backed checkout sessions. Reports the merchant checkout lifecycle.

Show merchant_res properties

string

Merchant lifecycle status. Examples include pending, prepared, paid, failed, prepare_failed, needs_human, and unknown.

string

Merchant checkout order id, when available.

string

Safe merchant error code, when available.

string

Safe merchant error message, when available.

object

May be present when a quote-backed checkout fails: { code, message }.

Notes

For non-quote checkouts, token and dynamic_cvv contain the virtual card credentials your agent uses at checkout.
Read transactions[].card_id as the source of truth for the card bound to the transaction, whether it was preselected or chosen on the collection surface.
For quote-backed checkouts, Prava completes the merchant checkout. Results contain credential-free transaction summaries (txn_id, card_id, and status) and expose the checkout lifecycle as merchant_res; they never include token, CVV, expiry, or line-item credentials.
Use the top-level status as the normalized payment outcome. merchant_res.status provides lifecycle context and uses merchant terms such as prepared and paid.
merchant_res is omitted for non-quote sessions and before an order exists; it is not returned as null.
Prava performs a lazy mandate expiry check on every request — expired mandates are reflected in the status.
After using non-quote checkout credentials, report the outcome via Report Status.

Error responses

Status	Code	Cause
401	`AUTH_1001`	Invalid API key
401	`AUTH_1002`	Missing or invalid Authorization header
404	`NOT_FOUND`	Session not found or doesn’t belong to your merchant account

curl "https://sandbox.api.prava.space/v1/sessions/sess_123/payment-result" \
  -H "Authorization: Bearer sk_test_..."

import requests

resp = requests.get(
    "https://sandbox.api.prava.space/v1/sessions/sess_123/payment-result",
    headers={"Authorization": "Bearer sk_test_..."},
)

const resp = await fetch("https://sandbox.api.prava.space/v1/sessions/sess_123/payment-result", {
  headers: {
    Authorization: "Bearer sk_test_...",
  },
});

{
  "session_id": "sess_123",
  "order_id": "ord_4a1b",
  "status": "awaiting_result",
  "transactions": [
    {
      "txn_id": "txn_1",
      "card_id": "card_42",
      "status": "awaiting_result",
      "line_items": [
        {
          "txn_ref_id": "tli_1",
          "merchant_name": "Acme Store",
          "total_amount": "49.99",
          "status": "credentials_generated",
          "token": "4111111111111111",
          "dynamic_cvv": "123",
          "expiry_month": "12",
          "expiry_year": "2030",
          "products": []
        }
      ]
    }
  ]
}

{
  "session_id": "sess_123",
  "order_id": "ord_4a1b",
  "status": "processing",
  "transactions": [
    {
      "txn_id": "txn_1",
      "card_id": "card_42",
      "status": "awaiting_result"
    }
  ],
  "merchant_res": {
    "status": "prepared"
  }
}

{
  "error": { "code": "AUTH_1002", "message": "Missing or invalid Authorization header" }
}

{
  "error": { "code": "NOT_FOUND", "message": "Session not found" }
}

Authorizations

Authorization

string

header

required

Your secret key: sk_test_* (sandbox) or sk_live_* (production).

Path Parameters

sessionId

string

required

The session ID returned from Create Session

Response

Payment result

session_id

string

required

order_id

string | null

required

status

enum<string>

required

Overall session status. processing means the payment operation is still in flight: a non-quote checkout is authenticating or tokenizing, or a quote-backed merchant checkout has not reached a terminal outcome.

Available options:

pending,

processing,

awaiting_result,

completed,

failed

transactions

object[]

required

Show child attributes

merchant_res

object

Merchant checkout lifecycle context. Present only for quote-backed sessions; omitted for non-quote sessions and before an order exists. Use the top-level status as the normalized payment outcome.

Show child attributes

error

object

May be present when a quote-backed checkout fails.

Show child attributes

Server-Side API

Reference

Path parameters

Response

Notes

Error responses

Authorizations

Path Parameters

Response

​Path parameters

​Response

​Notes

​Error responses

Authorizations

Path Parameters

Response

Path parameters

Response

Notes

Error responses