Retain signed measured fuel presentment and policy exceptions

POST/cards/fleet/presentments

Verified cards staff and fresh step-up for authority changes; independent operations:approve review. Fleet cards require exact signed svc_issuerproc driver/vehicle prompts, approved monetary ceiling and supported USD US fuel terminals. Final measured fuel quantity, tax-inclusive unit price and line totals are separately signed and retained. Out-of-policy final presentments remain pending until independently evidenced exception review; actual obligations cannot be erased by rejecting them. Normal authorization, clearing, force-presentment and increment entry points enforce these bindings. Transport, prompt verification and licensed scheme mapping belong to the issuer processor. See services/cards/fleet/README.md for exact integer units and signature contract.

Headers

Idempotency-KeystringOptional

Send on every write that creates or changes money or state; a replay with the same key returns the original result with 200.

Body parameters

payloadobjectRequired

23 child attributes

authority_idstringRequired

authority_sha256stringRequired

authorization_idstringOptional

Example auth_2tVh8nqLxq4GbDe0K1F6S9zRcWm

authorization_network_refstringOptional

card_idstringRequired

Example card_2tVh8nqLxq4GbDe0K1F6S9zRcWm

currency_codestringRequired

driver_referencestringRequired

effective_atstring · date-timeRequired

issued_atstring · date-timeRequired

key_idstringRequired

kindstringRequired

Authorize or presentment

linesarray of objectsOptional

6 child attributes

product_codestringRequired

quantity_milliintegerRequired

referencestringRequired

total_amountintegerRequired

unitstringRequired

unit_price_milli_minorintegerRequired

networkstringRequired

original_receipt_sha256stringOptional

product_code_systemstringOptional

product_code_versionstringOptional

receipt_referencestringRequired

source_evidenceobjectRequired

2 child attributes

referencestringRequired

sha256stringRequired

total_amountintegerRequired

transaction_sha256stringOptional

vehicle_referencestringRequired

verificationstringRequired

Driver_vehicle_verified or cleared_fuel_purchase

versionstringRequired

signaturestringRequired

Returns

200 OK

account_idstringRequired

Example acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm

authorization_idstringRequired

Example auth_2tVh8nqLxq4GbDe0K1F6S9zRcWm

authorization_useobjectRequired

7 child attributes

accepted_atstring · date-timeRequired

authorityobjectRequired

13 child attributes

account_idstringRequired

Example acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm

actorstringRequired

atstring · date-timeRequired

cardholder_authority_idstringRequired

Example chra_2tVh8nqLxq4GbDe0K1F6S9zRcWm

content_sha256stringRequired

funding_customer_idstringRequired

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

idstringRequired

ownership_revisionintegerRequired

product_codestringRequired

product_versionintegerRequired

requestobjectRequired

14 child attributes

card_idstringRequired

Example card_2tVh8nqLxq4GbDe0K1F6S9zRcWm

driver_customer_idstringRequired

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

driver_evidenceobjectRequired

driver_referencestringRequired

Opaque terminal/processor identity, never a PIN

expires_atstring · date-timeRequired

fuelsarray of objectsRequired

max_authorization_amountintegerRequired

policy_evidenceobjectRequired

previous_authority_idstringOptional

product_code_systemstringRequired

product_code_versionstringRequired

reasonstringRequired

vehicle_evidenceobjectRequired

vehicle_referencestringRequired

reviewobject or nullOptional

6 child attributes

actorstringRequired

approvebooleanRequired

atstring · date-timeRequired

content_sha256stringRequired

evidenceobjectRequired

reasonstringRequired

revocationobject or nullOptional

5 child attributes

actorstringRequired

atstring · date-timeRequired

content_sha256stringRequired

evidenceobjectRequired

reasonstringRequired

network_refstringRequired

receiptobjectRequired

2 child attributes

payloadobjectRequired

23 child attributes

authority_idstringRequired

authority_sha256stringRequired

authorization_idstringOptional

Example auth_2tVh8nqLxq4GbDe0K1F6S9zRcWm

authorization_network_refstringOptional

card_idstringRequired

Example card_2tVh8nqLxq4GbDe0K1F6S9zRcWm

currency_codestringRequired

driver_referencestringRequired

effective_atstring · date-timeRequired

issued_atstring · date-timeRequired

key_idstringRequired

kindstringRequired

Authorize or presentment

linesarray of objectsOptional

networkstringRequired

original_receipt_sha256stringOptional

product_code_systemstringOptional

product_code_versionstringOptional

receipt_referencestringRequired

source_evidenceobjectRequired

total_amountintegerRequired

transaction_sha256stringOptional

vehicle_referencestringRequired

verificationstringRequired

Driver_vehicle_verified or cleared_fuel_purchase

versionstringRequired

signaturestringRequired

transactionobjectRequired

Transaction deliberately excludes PAN/token secrets and includes every merchant and approval term which Authorize accepts. Final pump quantity is not asserted here.

12 child attributes

amountintegerRequired

channelstringRequired

countrystringRequired

currency_codestringRequired

mccstringRequired

merchant_idstringRequired

merchant_locationstringRequired

merchant_namestringRequired

merchant_postal_codestringRequired

merchant_regionstringRequired

network_refstringRequired

partial_approval_allowedbooleanRequired

trust_config_sha256stringRequired

verification_keyobjectRequired

5 child attributes

idstringRequired

networkstringRequired

public_keystringRequired

valid_fromstring · date-timeRequired

valid_throughstring · date-timeRequired

captured_atstring · date-timeRequired

captured_bystringRequired

content_sha256stringRequired

receiptobjectRequired

2 child attributes

payloadobjectRequired

23 child attributes

authority_idstringRequired

authority_sha256stringRequired

authorization_idstringOptional

Example auth_2tVh8nqLxq4GbDe0K1F6S9zRcWm

authorization_network_refstringOptional

card_idstringRequired

Example card_2tVh8nqLxq4GbDe0K1F6S9zRcWm

currency_codestringRequired

driver_referencestringRequired

effective_atstring · date-timeRequired

issued_atstring · date-timeRequired

key_idstringRequired

kindstringRequired

Authorize or presentment

linesarray of objectsOptional

6 child attributes

product_codestringRequired

quantity_milliintegerRequired

referencestringRequired

total_amountintegerRequired

unitstringRequired

unit_price_milli_minorintegerRequired

networkstringRequired

original_receipt_sha256stringOptional

product_code_systemstringOptional

product_code_versionstringOptional

receipt_referencestringRequired

source_evidenceobjectRequired

2 child attributes

referencestringRequired

sha256stringRequired

total_amountintegerRequired

transaction_sha256stringOptional

vehicle_referencestringRequired

verificationstringRequired

Driver_vehicle_verified or cleared_fuel_purchase

versionstringRequired

signaturestringRequired

resultobject or nullOptional

3 child attributes

atstring · date-timeRequired

cleared_amountintegerRequired

journal_idstringRequired

Example jrnl_2tVh8nqLxq4GbDe0K1F6S9zRcWm

reviewobject or nullOptional

6 child attributes

actorstringRequired

approvebooleanRequired

atstring · date-timeRequired

content_sha256stringRequired

evidenceobjectRequired

2 child attributes

referencestringRequired

sha256stringRequired

reasonstringRequired

trust_config_sha256stringRequired

verification_keyobjectRequired

5 child attributes

idstringRequired

networkstringRequired

public_keystringRequired

valid_fromstring · date-timeRequired

valid_throughstring · date-timeRequired

violationsarray of stringsRequired

Errors

Every error is a problem document with a stable code. See Errors.

400401403404409412413422424429500503

Request

curl -X POST 'https://api.dev.bank.corgi.com/cards/fleet/presentments' \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "payload": {
      "authority_id": "string",
      "authority_sha256": "string",
      "authorization_id": "auth_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
      "authorization_network_ref": "string",
      "card_id": "card_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
      "currency_code": "USD",
      "driver_reference": "string",
      "effective_at": "2026-09-17T14:30:00Z",
      "issued_at": "2026-09-17T14:30:00Z",
      "key_id": "string",
      "kind": "string",
      "lines": [
        {
          "product_code": "string",
          "quantity_milli": 0,
          "reference": "string",
          "total_amount": 10000,
          "unit": "string",
          "unit_price_milli_minor": 0
        }
      ],
      "network": "string",
      "original_receipt_sha256": "string",
      "product_code_system": "string",
      "product_code_version": "string",
      "receipt_reference": "string",
      "source_evidence": {
        "reference": "string",
        "sha256": "string"
      },
      "total_amount": 10000,
      "transaction_sha256": "string",
      "vehicle_reference": "string",
      "verification": "string",
      "version": "string"
    },
    "signature": "string"
  }'

Response200

{
  "account_id": "acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "authorization_id": "auth_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "authorization_use": {
    "accepted_at": "2026-09-17T14:30:00Z",
    "authority": {
      "account_id": "acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
      "actor": "string",
      "at": "2026-09-17T14:30:00Z",
      "cardholder_authority_id": "chra_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
      "content_sha256": "string",
      "funding_customer_id": "cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
      "id": "string",
      "ownership_revision": 0,
      "product_code": "string",
      "product_version": 0,
      "request": {
        "card_id": "card_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
        "driver_customer_id": "cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
        "driver_evidence": {},
        "driver_reference": "string",
        "expires_at": "2026-09-17T14:30:00Z",
        "fuels": [],
        "max_authorization_amount": 10000,
        "policy_evidence": {},
        "previous_authority_id": "string",
        "product_code_system": "string",
        "product_code_version": "string",
        "reason": "string",
        "vehicle_evidence": {},
        "vehicle_reference": "string"
      },
      "review": {
        "actor": "string",
        "approve": false,
        "at": "2026-09-17T14:30:00Z",
        "content_sha256": "string",
        "evidence": {},
        "reason": "string"
      },
      "revocation": {
        "actor": "string",
        "at": "2026-09-17T14:30:00Z",
        "content_sha256": "string",
        "evidence": {},
        "reason": "string"
      }
    },
    "network_ref": "string",
    "receipt": {
      "payload": {
        "authority_id": "string",
        "authority_sha256": "string",
        "authorization_id": "auth_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
        "authorization_network_ref": "string",
        "card_id": "card_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
        "currency_code": "USD",
        "driver_reference": "string",
        "effective_at": "2026-09-17T14:30:00Z",
        "issued_at": "2026-09-17T14:30:00Z",
        "key_id": "string",
        "kind": "string",
        "lines": [],
        "network": "string",
        "original_receipt_sha256": "string",
        "product_code_system": "string",
        "product_code_version": "string",
        "receipt_reference": "string",
        "source_evidence": {},
        "total_amount": 10000,
        "transaction_sha256": "string",
        "vehicle_reference": "string",
        "verification": "string",
        "version": "string"
      },
      "signature": "string"
    },
    "transaction": {
      "amount": 10000,
      "channel": "string",
      "country": "string",
      "currency_code": "USD",
      "mcc": "string",
      "merchant_id": "string",
      "merchant_location": "string",
      "merchant_name": "string",
      "merchant_postal_code": "string",
      "merchant_region": "string",
      "network_ref": "string",
      "partial_approval_allowed": false
    },
    "trust_config_sha256": "string",
    "verification_key": {
      "id": "string",
      "network": "string",
      "public_key": "string",
      "valid_from": "2026-09-17T14:30:00Z",
      "valid_through": "2026-09-17T14:30:00Z"
    }
  },
  "captured_at": "2026-09-17T14:30:00Z",
  "captured_by": "string",
  "content_sha256": "string",
  "receipt": {
    "payload": {
      "authority_id": "string",
      "authority_sha256": "string",
      "authorization_id": "auth_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
      "authorization_network_ref": "string",
      "card_id": "card_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
      "currency_code": "USD",
      "driver_reference": "string",
      "effective_at": "2026-09-17T14:30:00Z",
      "issued_at": "2026-09-17T14:30:00Z",
      "key_id": "string",
      "kind": "string",
      "lines": [
        {}
      ],
      "network": "string",
      "original_receipt_sha256": "string",
      "product_code_system": "string",
      "product_code_version": "string",
      "receipt_reference": "string",
      "source_evidence": {
        "reference": "string",
        "sha256": "string"
      },
      "total_amount": 10000,
      "transaction_sha256": "string",
      "vehicle_reference": "string",
      "verification": "string",
      "version": "string"
    },
    "signature": "string"
  },
  "result": {
    "at": "2026-09-17T14:30:00Z",
    "cleared_amount": 10000,
    "journal_id": "jrnl_2tVh8nqLxq4GbDe0K1F6S9zRcWm"
  },
  "review": {
    "actor": "string",
    "approve": false,
    "at": "2026-09-17T14:30:00Z",
    "content_sha256": "string",
    "evidence": {
      "reference": "string",
      "sha256": "string"
    },
    "reason": "string"
  },
  "trust_config_sha256": "string",
  "verification_key": {
    "id": "string",
    "network": "string",
    "public_key": "string",
    "valid_from": "2026-09-17T14:30:00Z",
    "valid_through": "2026-09-17T14:30:00Z"
  },
  "violations": [
    "string"
  ]
}