Référence de l’API checkout

Rechercher dans tous les points de terminaison

/v1/checkout/

GET

/v1/checkout/get_context

Public-by-design: same-origin guest payment preparation uses a session-bound anti-forgery token.

Exemple de requête (cURL)

curl --get \
  'https://fr.appointmenttrader.com/v1/checkout/get_context' \
  --data-urlencode 'key={{API_KEY}}'

Retour

JSON

See the shared response schema and synthetic example.

Champs de réponse

Champ	Type	Obligatoire	Description
`$`	`checkout_get_context_Response`	`Oui`
`$.oneOf[0]`		`Oui`
`$.oneOf[0].allOf[0]`	`object`	`Oui`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`Oui`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`Oui`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`Oui`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]`	`array`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`Non`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]`	`object`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`Non`
`$.oneOf[0].allOf[0].RequestImpersonatedByUserAlias`	`string`	`Non`
`$.oneOf[0].allOf[1]`	`object`	`Oui`
`$.oneOf[0].allOf[1].Payload`	`object`	`Oui`
`$.oneOf[0].allOf[1].Payload.csrf`	`string`	`Oui`	Opaque anti-forgery token bound to the browser session. Synthetic examples never contain a usable token.
`$.oneOf[0].allOf[1].Payload.settings`	`object`	`Oui`
`$.oneOf[0].allOf[1].Payload.settings.listing`	`boolean`	`Oui`
`$.oneOf[0].allOf[1].Payload.settings.bid`	`boolean`	`Oui`
`$.oneOf[1]`	`object`	`Oui`
`$.oneOf[1].RequestUserAlias`	`string`	`Oui`
`$.oneOf[1].RequestPath`	`string \| null`	`Oui`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`Oui`
`$.oneOf[1].ResponseCode`	`integer`	`Oui`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[1]`	`array`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`Non`
`$.oneOf[1].ResponseMessage.oneOf[2]`	`object`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`Non`
`$.oneOf[1].RequestImpersonatedByUserAlias`	`string`	`Non`

Exemple de réponse

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/checkout/get_context",
    "RequestUserAlias": "example-user",
    "Payload": {
        "csrf": "FAKE_CSRF_TOKEN",
        "settings": {
            "listing": false,
            "bid": false
        }
    }
}

Documentation du point de terminaison lisible par machine

GET

/v1/checkout/get_status

Public-by-design: only the originating browser or verified intended buyer can read this attempt.

Paramètres

Nom	Type	Obligatoire	Valeur par défaut	Description
`attempt`	`string`	`Oui`	`—`	Opaque checkout attempt.

Exemple de requête (cURL)

curl --get \
  'https://fr.appointmenttrader.com/v1/checkout/get_status' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'attempt={{attempt}}'

Retour

JSON

See the shared response schema and synthetic example.

Champs de réponse

Champ	Type	Obligatoire
`$`	`checkout_get_status_Response`	`Oui`
`$.oneOf[0]`		`Oui`
`$.oneOf[0].allOf[0]`	`object`	`Oui`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`Oui`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`Oui`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`Oui`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]`	`array`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`Non`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]`	`object`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`Non`
`$.oneOf[0].allOf[0].RequestImpersonatedByUserAlias`	`string`	`Non`
`$.oneOf[0].allOf[1]`	`object`	`Oui`
`$.oneOf[0].allOf[1].Payload`	`object`	`Oui`
`$.oneOf[0].allOf[1].Payload.attempt`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.expiresAt`	`integer`	`Oui`
`$.oneOf[0].allOf[1].Payload.serverTime`	`integer`	`Oui`
`$.oneOf[0].allOf[1].Payload.flow`	`string ["listing","bid"]`	`Oui`
`$.oneOf[0].allOf[1].Payload.resumeURL`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.state`	`string ["prepared","authorized","completing","completed","canceling","canceled","expired","recovery"]`	`Oui`
`$.oneOf[0].allOf[1].Payload.paymentState`		`Oui`
`$.oneOf[0].allOf[1].Payload.paymentState.anyOf[0]`	`string ["requires_payment_method","requires_confirmation","requires_action","processing","requires_capture","canceled","succeeded"]`	`Oui`
`$.oneOf[0].allOf[1].Payload.paymentState.anyOf[1]`	`null`	`Oui`
`$.oneOf[0].allOf[1].Payload.resultURL`		`Oui`
`$.oneOf[0].allOf[1].Payload.resultURL.anyOf[0]`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.resultURL.anyOf[1]`	`null`	`Oui`
`$.oneOf[1]`	`object`	`Oui`
`$.oneOf[1].RequestUserAlias`	`string`	`Oui`
`$.oneOf[1].RequestPath`	`string \| null`	`Oui`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`Oui`
`$.oneOf[1].ResponseCode`	`integer`	`Oui`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[1]`	`array`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`Non`
`$.oneOf[1].ResponseMessage.oneOf[2]`	`object`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`Non`
`$.oneOf[1].RequestImpersonatedByUserAlias`	`string`	`Non`

Exemple de réponse

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/checkout/get_status",
    "RequestUserAlias": "example-user",
    "Payload": {
        "attempt": "synthetic-example",
        "expiresAt": 0,
        "serverTime": 0,
        "flow": "listing",
        "resumeURL": "synthetic-example",
        "state": "prepared",
        "paymentState": "requires_payment_method",
        "resultURL": "synthetic-example"
    }
}

Documentation du point de terminaison lisible par machine

POST

/v1/checkout/set_cancel

Public-by-design: cancellation requires the originating browser's token and attempt ownership.

Paramètres

Nom	Type	Obligatoire	Valeur par défaut	Description
`attempt`	`string`	`Oui`	`—`	Opaque checkout attempt.
`csrf`	`string`	`Oui`	`—`	Browser token from get_context. POST required.

Exemple de requête (cURL)

curl --request POST \
  'https://fr.appointmenttrader.com/v1/checkout/set_cancel' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'attempt={{attempt}}' \
  --data-urlencode 'csrf={{csrf}}'

Retour

JSON

See the shared response schema and synthetic example.

Champs de réponse

Champ	Type	Obligatoire
`$`	`checkout_set_cancel_Response`	`Oui`
`$.oneOf[0]`		`Oui`
`$.oneOf[0].allOf[0]`	`object`	`Oui`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`Oui`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`Oui`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`Oui`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]`	`array`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`Non`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]`	`object`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`Non`
`$.oneOf[0].allOf[0].RequestImpersonatedByUserAlias`	`string`	`Non`
`$.oneOf[0].allOf[1]`	`object`	`Oui`
`$.oneOf[0].allOf[1].Payload`	`= true`	`Oui`
`$.oneOf[1]`	`object`	`Oui`
`$.oneOf[1].RequestUserAlias`	`string`	`Oui`
`$.oneOf[1].RequestPath`	`string \| null`	`Oui`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`Oui`
`$.oneOf[1].ResponseCode`	`integer`	`Oui`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[1]`	`array`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`Non`
`$.oneOf[1].ResponseMessage.oneOf[2]`	`object`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`Non`
`$.oneOf[1].RequestImpersonatedByUserAlias`	`string`	`Non`

Exemple de réponse

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/checkout/set_cancel",
    "RequestUserAlias": "example-user",
    "Payload": true
}

Documentation du point de terminaison lisible par machine

POST

/v1/checkout/set_prepare

Public-by-design: prepares a session-owned manual-capture payment; never purchases or creates a bid.

Paramètres

Nom	Type	Obligatoire	Valeur par défaut	Description
`payloadJSON`	`string`	`Oui`	`—`	Listing UUID or canonical composer checkout fields and the selected reward.
`requestKey`	`string`	`Oui`	`—`	Random 64-character hexadecimal retry identity.
`csrf`	`string`	`Oui`	`—`	Browser token from get_context. POST required.

Exemple de requête (cURL)

curl --request POST \
  'https://fr.appointmenttrader.com/v1/checkout/set_prepare' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'payloadJSON={{payloadJSON}}' \
  --data-urlencode 'requestKey={{requestKey}}' \
  --data-urlencode 'csrf={{csrf}}'

Retour

JSON

See the shared response schema and synthetic example.

Paramètres: payloadJSON

Champ	Type	Obligatoire	Description
`payloadJSON`	`string (application/json)`	`Oui`
`payloadJSON`	`GuestCheckoutPrepareInput (JSON décodé)`	`Oui`
`payloadJSON.oneOf[0]`	`object`	`Oui`
`payloadJSON.oneOf[0].listingUUID`	`string`	`Oui`
`payloadJSON.oneOf[0].expectedAmount`	`integer`	`Oui`
`payloadJSON.oneOf[1]`	`object`	`Oui`	Canonical fields must match the session-owned frozen composer snapshot. composersnapshot is an opaque token, not serialized request content. expectedAmount is the displayed total in USD cents; bidamount is the displayed principal in the active currency. Unknown fields are discarded.
`payloadJSON.oneOf[1].lid`	`DatabaseInteger`	`Oui`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`payloadJSON.oneOf[1].lid.oneOf[0]`	`integer`	`Oui`
`payloadJSON.oneOf[1].lid.oneOf[1]`	`string`	`Oui`
`payloadJSON.oneOf[1].inventorytypeid`	`DatabaseInteger`	`Oui`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`payloadJSON.oneOf[1].inventorytypeid.oneOf[0]`	`integer`	`Oui`
`payloadJSON.oneOf[1].inventorytypeid.oneOf[1]`	`string`	`Oui`
`payloadJSON.oneOf[1].unit`	`DatabaseInteger`	`Oui`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`payloadJSON.oneOf[1].unit.oneOf[0]`	`integer`	`Oui`
`payloadJSON.oneOf[1].unit.oneOf[1]`	`string`	`Oui`
`payloadJSON.oneOf[1].bidamount`	`DatabaseNumber`	`Oui`	Numeric value; MySQL reads can serialize numbers as numeric strings.
`payloadJSON.oneOf[1].bidamount.oneOf[0]`	`number`	`Oui`
`payloadJSON.oneOf[1].bidamount.oneOf[1]`	`string`	`Oui`
`payloadJSON.oneOf[1].startdate`	`string`	`Oui`
`payloadJSON.oneOf[1].enddate`	`string`	`Oui`
`payloadJSON.oneOf[1].starttime`	`string`	`Non`
`payloadJSON.oneOf[1].enddtime`	`string`	`Non`
`payloadJSON.oneOf[1].exactstarttime`	`string`	`Oui`
`payloadJSON.oneOf[1].exactendtime`	`string`	`Oui`
`payloadJSON.oneOf[1].cuidl`	`string`	`Non`
`payloadJSON.oneOf[1].composersnapshot`	`string`	`Oui`
`payloadJSON.oneOf[1].atv2ComposerDraftInstanceKey`	`string`	`Non`
`payloadJSON.oneOf[1].atv2ComposerDraftViewerKey`	`string`	`Non`
`payloadJSON.oneOf[1].urid`	`DatabaseInteger`	`Non`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`payloadJSON.oneOf[1].urid.oneOf[0]`	`integer`	`Non`
`payloadJSON.oneOf[1].urid.oneOf[1]`	`string`	`Non`
`payloadJSON.oneOf[1].composerurid`	`DatabaseInteger`	`Non`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`payloadJSON.oneOf[1].composerurid.oneOf[0]`	`integer`	`Non`
`payloadJSON.oneOf[1].composerurid.oneOf[1]`	`string`	`Non`
`payloadJSON.oneOf[1].premiumbid`		`Non`	Presence selects the premium fee; omit entirely for standard pricing.
`payloadJSON.oneOf[1].premiumbid.anyOf[0]`	`string`	`Non`
`payloadJSON.oneOf[1].premiumbid.anyOf[1]`	`boolean`	`Non`
`payloadJSON.oneOf[1].premiumbid.anyOf[2]`	`integer`	`Non`
`payloadJSON.oneOf[1].expectedAmount`	`integer`	`Oui`

Champs de réponse

Champ	Type	Obligatoire	Description
`$`	`checkout_set_prepare_Response`	`Oui`
`$.oneOf[0]`		`Oui`
`$.oneOf[0].allOf[0]`	`object`	`Oui`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`Oui`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`Oui`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`Oui`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]`	`array`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`Non`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]`	`object`	`Oui`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`Non`
`$.oneOf[0].allOf[0].RequestImpersonatedByUserAlias`	`string`	`Non`
`$.oneOf[0].allOf[1]`	`object`	`Oui`
`$.oneOf[0].allOf[1].Payload`	`object`	`Oui`
`$.oneOf[0].allOf[1].Payload.attempt`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.expiresAt`	`integer`	`Oui`
`$.oneOf[0].allOf[1].Payload.serverTime`	`integer`	`Oui`
`$.oneOf[0].allOf[1].Payload.flow`	`string ["listing","bid"]`	`Oui`
`$.oneOf[0].allOf[1].Payload.resumeURL`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.clientSecret`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.paymentIntentID`	`string`	`Oui`
`$.oneOf[0].allOf[1].Payload.paymentState`	`string ["requires_payment_method","requires_confirmation","requires_action","processing","requires_capture","canceled","succeeded"]`	`Oui`
`$.oneOf[0].allOf[1].Payload.amount`	`integer`	`Oui`	Total payable USD cents including the applicable publishing fee.
`$.oneOf[1]`	`object`	`Oui`
`$.oneOf[1].RequestUserAlias`	`string`	`Oui`
`$.oneOf[1].RequestPath`	`string \| null`	`Oui`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`Oui`
`$.oneOf[1].ResponseCode`	`integer`	`Oui`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[1]`	`array`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`Non`
`$.oneOf[1].ResponseMessage.oneOf[2]`	`object`	`Oui`
`$.oneOf[1].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`Non`
`$.oneOf[1].RequestImpersonatedByUserAlias`	`string`	`Non`

Exemple de réponse

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/checkout/set_prepare",
    "RequestUserAlias": "example-user",
    "Payload": {
        "attempt": "synthetic-example",
        "expiresAt": 0,
        "serverTime": 0,
        "flow": "listing",
        "resumeURL": "synthetic-example",
        "clientSecret": "pi_FAKE_secret_PLACEHOLDER",
        "paymentIntentID": "pi_FAKE",
        "paymentState": "requires_payment_method",
        "amount": 0
    }
}

Documentation du point de terminaison lisible par machine