Deposit requests

Get the Proof of Payment

GET/v1/deposit-requests/{id}/proof

Retrieves the Proof of Payment for a settled request.

API key · or dashboard session.

Request

Shell
curl -fsS "$API/v1/deposit-requests/dr_0198f80c-…/proof" \
  -H "Authorization: Bearer $PAYDAY_API_KEY" > proof.json

Response

200 OK
{
  "version": "payday.proof.v2",
  "payment_id": "dr_0198f80c-8d2f-7dc1-a369-90556a64f700",
  "canonical_issuance_snapshot": { "schema": "payday.invoice", "canonicalization": "RFC8785", "…": "…" },
  "canonicalization": "RFC8785",
  "attribution_hash": "0x…",
  "payer_wallet": { "address": "0x5aAe…", "typed_data": { "…": "…" }, "digest": "0x…", "signature": "0x…", "method": "ecdsa" },
  "salt": "0x…",
  "chain_id": "143",
  "factory_address": "0x…",
  "payment_address": "0x2222222222222222222222222222222222222222",
  "token_address": "0x754704Bc059F8C67012fEd69BC8A327a5aafb603",
  "recovery_address": "0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed",
  "settlement_transaction_hash": "0x…",
  "transfers": [ { "transaction_hash": "0x…", "log_index": "12", "sender": "0x5aAe…", "recipient": "0x2222…", "amount_base_units": "10500000", "block_number": "98765432" } ],
  "verification": { "payload": { "…": "…" }, "signer": "0x…", "signature": "0x…" }
}

Document version payday.proof.v2: canonical issuance snapshot, attribution hash, payer wallet attestation, salt, chain, factory, token, deposit and recovery addresses, credited transfers, settlement transaction hash, and a Payday-signed verification attestation. Verifiable offline; reference implementation gateway_core::verify_proof. Schema: Proof of Payment.

Path parameters

iddr_ idrequired

Response

ProofOfPayment.

Status codes

  • 200
  • 409deposit_request_not_settled
  • 409deposit_sender_mismatch A credited transfer originated from a wallet other than payer_wallet. No proof is issued.