Pricing & booking

Submit a typed SPT payment with Idempotency-Key, or a legacy flat Shared Payment Token

Typed submissions require a jnk_ API key via X-API-Key (ApiKeyAuth) or Authorization: Bearer (BearerAuth), a tenant-bound booking scope, quote_id and Idempotency-Key, and return a PaymentAttemptOutcome (200 known outcome / 202 pending). OAuth/JWT bearer tokens are supported only for the legacy flat token body, which keeps its existing authorization response. Request bodies are limited to 16 KiB.

post/v1/agent_payment/submit

Request

  • Base URL
    https://api.gojinko.com
  • URL
    https://api.gojinko.com/v1/agent_payment/submit
  • Auth
    • API key in header X-API-Key
    • or HTTP bearer

Headers

Idempotency-Keystring

Required on a typed submission (a body with payment); without it the request is refused with 400 CREDENTIAL_FORMAT_INVALID. Ignored on the legacy body. 1–255 printable ASCII characters. Reuse only for the same payment submission: the same key with the same body replays the first outcome, with a different body it is refused.

Request body

OR

Example request

{
  "quote_id": "2097152"
}

Response

Legacy authorization result or typed payment outcome

OR

Example response

{
  "trip_id": "trip_1048576",
  "quote_id": "2097152",
  "failure_reason": "booking_not_created",
  "items": [
    {
      "booked_item_id": "itm_aaaaaaaaaaaaafhuxsdxpbzrbfz5hm3a",
      "failure_reason": "booking_not_created"
    }
  ],
  "money": {
    "authorized": {
      "value": 41250,
      "currency": "USD",
      "decimal_places": 2,
      "display": "USD 412.50"
    },
    "captured": {
      "value": 41250,
      "currency": "USD",
      "decimal_places": 2,
      "display": "USD 412.50"
    },
    "released": {
      "value": 41250,
      "currency": "USD",
      "decimal_places": 2,
      "display": "USD 412.50"
    },
    "refunded": {
      "value": 41250,
      "currency": "USD",
      "decimal_places": 2,
      "display": "USD 412.50"
    },
    "externally_reimbursed": {
      "value": 41250,
      "currency": "USD",
      "decimal_places": 2,
      "display": "USD 412.50"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.