AT AppointmentTrader
로그인
현재 온라인  

/v1/checkout/

GET

/v1/checkout/get_context

#
Public-by-design: same-origin guest payment preparation uses a session-bound anti-forgery token.
요청 예제(cURL) 
curl --get \
  'https://kr.appointmenttrader.com/v1/checkout/get_context' \
  --data-urlencode 'key={{API_KEY}}'

반환값

JSON
See the shared response schema and synthetic example.
응답 필드
필드유형필수설명
$checkout_get_context_Response 예
$.oneOf[0] 예
$.oneOf[0].allOf[0]object 예
$.oneOf[0].allOf[0].RequestUserAliasstring 예
$.oneOf[0].allOf[0].RequestPathstring | null 예
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" 예
$.oneOf[0].allOf[0].ResponseCodeinteger 예
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring 아니요
$.oneOf[0].allOf[1]object 예
$.oneOf[0].allOf[1].Payloadobject 예
$.oneOf[0].allOf[1].Payload.csrfstring 예Opaque anti-forgery token bound to the browser session. Synthetic examples never contain a usable token.
$.oneOf[0].allOf[1].Payload.settingsobject 예
$.oneOf[0].allOf[1].Payload.settings.listingboolean 예
$.oneOf[0].allOf[1].Payload.settings.bidboolean 예
$.oneOf[1]object 예
$.oneOf[1].RequestUserAliasstring 예
$.oneOf[1].RequestPathstring | null 예
$.oneOf[1].RequestStatus = "Failed" 예
$.oneOf[1].ResponseCodeinteger 예
$.oneOf[1].ResponseMessageAPIResponseMessage 예
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[1].ResponseMessage.oneOf[1]array 예
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[1].ResponseMessage.oneOf[2]object 예
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[1].RequestImpersonatedByUserAliasstring 아니요
응답 예제 
{
    "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
        }
    }
}
기계가 읽을 수 있는 엔드포인트 문서
GET

/v1/checkout/get_status

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

매개변수

이름유형필수기본값설명
attempt string 예 — Opaque checkout attempt.
요청 예제(cURL) 
curl --get \
  'https://kr.appointmenttrader.com/v1/checkout/get_status' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'attempt={{attempt}}'

반환값

JSON
See the shared response schema and synthetic example.
응답 필드
필드유형필수설명
$checkout_get_status_Response 예
$.oneOf[0] 예
$.oneOf[0].allOf[0]object 예
$.oneOf[0].allOf[0].RequestUserAliasstring 예
$.oneOf[0].allOf[0].RequestPathstring | null 예
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" 예
$.oneOf[0].allOf[0].ResponseCodeinteger 예
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring 아니요
$.oneOf[0].allOf[1]object 예
$.oneOf[0].allOf[1].Payloadobject 예
$.oneOf[0].allOf[1].Payload.attemptstring 예
$.oneOf[0].allOf[1].Payload.expiresAtinteger 예
$.oneOf[0].allOf[1].Payload.serverTimeinteger 예
$.oneOf[0].allOf[1].Payload.flowstring ["listing","bid"] 예
$.oneOf[0].allOf[1].Payload.resumeURLstring 예
$.oneOf[0].allOf[1].Payload.statestring ["prepared","authorized","completing","completed","canceling","canceled","expired","recovery"] 예
$.oneOf[0].allOf[1].Payload.paymentState 예
$.oneOf[0].allOf[1].Payload.paymentState.anyOf[0]string ["requires_payment_method","requires_confirmation","requires_action","processing","requires_capture","canceled","succeeded"] 예
$.oneOf[0].allOf[1].Payload.paymentState.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.resultURL 예
$.oneOf[0].allOf[1].Payload.resultURL.anyOf[0]string 예
$.oneOf[0].allOf[1].Payload.resultURL.anyOf[1]null 예
$.oneOf[1]object 예
$.oneOf[1].RequestUserAliasstring 예
$.oneOf[1].RequestPathstring | null 예
$.oneOf[1].RequestStatus = "Failed" 예
$.oneOf[1].ResponseCodeinteger 예
$.oneOf[1].ResponseMessageAPIResponseMessage 예
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[1].ResponseMessage.oneOf[1]array 예
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[1].ResponseMessage.oneOf[2]object 예
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[1].RequestImpersonatedByUserAliasstring 아니요
응답 예제 
{
    "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"
    }
}
기계가 읽을 수 있는 엔드포인트 문서
POST

/v1/checkout/set_cancel

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

매개변수

이름유형필수기본값설명
attempt string 예 — Opaque checkout attempt.
csrf string 예 — Browser token from get_context. POST required.
요청 예제(cURL) 
curl --request POST \
  'https://kr.appointmenttrader.com/v1/checkout/set_cancel' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'attempt={{attempt}}' \
  --data-urlencode 'csrf={{csrf}}'

반환값

JSON
See the shared response schema and synthetic example.
응답 필드
필드유형필수설명
$checkout_set_cancel_Response 예
$.oneOf[0] 예
$.oneOf[0].allOf[0]object 예
$.oneOf[0].allOf[0].RequestUserAliasstring 예
$.oneOf[0].allOf[0].RequestPathstring | null 예
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" 예
$.oneOf[0].allOf[0].ResponseCodeinteger 예
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring 아니요
$.oneOf[0].allOf[1]object 예
$.oneOf[0].allOf[1].Payload = true 예
$.oneOf[1]object 예
$.oneOf[1].RequestUserAliasstring 예
$.oneOf[1].RequestPathstring | null 예
$.oneOf[1].RequestStatus = "Failed" 예
$.oneOf[1].ResponseCodeinteger 예
$.oneOf[1].ResponseMessageAPIResponseMessage 예
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[1].ResponseMessage.oneOf[1]array 예
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[1].ResponseMessage.oneOf[2]object 예
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[1].RequestImpersonatedByUserAliasstring 아니요
응답 예제 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/checkout/set_cancel",
    "RequestUserAlias": "example-user",
    "Payload": true
}
기계가 읽을 수 있는 엔드포인트 문서
POST

/v1/checkout/set_prepare

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

매개변수

이름유형필수기본값설명
payloadJSON string 예 — Listing UUID or canonical composer checkout fields and the selected reward.
requestKey string 예 — Random 64-character hexadecimal retry identity.
csrf string 예 — Browser token from get_context. POST required.
요청 예제(cURL) 
curl --request POST \
  'https://kr.appointmenttrader.com/v1/checkout/set_prepare' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'payloadJSON={{payloadJSON}}' \
  --data-urlencode 'requestKey={{requestKey}}' \
  --data-urlencode 'csrf={{csrf}}'

반환값

JSON
See the shared response schema and synthetic example.
매개변수: payloadJSON
필드유형필수설명
payloadJSONstring (application/json) 예
payloadJSONGuestCheckoutPrepareInput (디코딩된 JSON) 예
payloadJSON.oneOf[0]object 예
payloadJSON.oneOf[0].listingUUIDstring 예
payloadJSON.oneOf[0].expectedAmountinteger 예
payloadJSON.oneOf[1]object 예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].lidDatabaseInteger 예Integer value; legacy MySQL reads may serialize it as a numeric string.
payloadJSON.oneOf[1].lid.oneOf[0]integer 예
payloadJSON.oneOf[1].lid.oneOf[1]string 예
payloadJSON.oneOf[1].inventorytypeidDatabaseInteger 예Integer value; legacy MySQL reads may serialize it as a numeric string.
payloadJSON.oneOf[1].inventorytypeid.oneOf[0]integer 예
payloadJSON.oneOf[1].inventorytypeid.oneOf[1]string 예
payloadJSON.oneOf[1].unitDatabaseInteger 예Integer value; legacy MySQL reads may serialize it as a numeric string.
payloadJSON.oneOf[1].unit.oneOf[0]integer 예
payloadJSON.oneOf[1].unit.oneOf[1]string 예
payloadJSON.oneOf[1].bidamountDatabaseNumber 예Numeric value; MySQL reads can serialize numbers as numeric strings.
payloadJSON.oneOf[1].bidamount.oneOf[0]number 예
payloadJSON.oneOf[1].bidamount.oneOf[1]string 예
payloadJSON.oneOf[1].startdatestring 예
payloadJSON.oneOf[1].enddatestring 예
payloadJSON.oneOf[1].starttimestring 아니요
payloadJSON.oneOf[1].enddtimestring 아니요
payloadJSON.oneOf[1].exactstarttimestring 예
payloadJSON.oneOf[1].exactendtimestring 예
payloadJSON.oneOf[1].cuidlstring 아니요
payloadJSON.oneOf[1].composersnapshotstring 예
payloadJSON.oneOf[1].atv2ComposerDraftInstanceKeystring 아니요
payloadJSON.oneOf[1].atv2ComposerDraftViewerKeystring 아니요
payloadJSON.oneOf[1].uridDatabaseInteger 아니요Integer value; legacy MySQL reads may serialize it as a numeric string.
payloadJSON.oneOf[1].urid.oneOf[0]integer 아니요
payloadJSON.oneOf[1].urid.oneOf[1]string 아니요
payloadJSON.oneOf[1].composeruridDatabaseInteger 아니요Integer value; legacy MySQL reads may serialize it as a numeric string.
payloadJSON.oneOf[1].composerurid.oneOf[0]integer 아니요
payloadJSON.oneOf[1].composerurid.oneOf[1]string 아니요
payloadJSON.oneOf[1].premiumbid 아니요Presence selects the premium fee; omit entirely for standard pricing.
payloadJSON.oneOf[1].premiumbid.anyOf[0]string 아니요
payloadJSON.oneOf[1].premiumbid.anyOf[1]boolean 아니요
payloadJSON.oneOf[1].premiumbid.anyOf[2]integer 아니요
payloadJSON.oneOf[1].expectedAmountinteger 예
응답 필드
필드유형필수설명
$checkout_set_prepare_Response 예
$.oneOf[0] 예
$.oneOf[0].allOf[0]object 예
$.oneOf[0].allOf[0].RequestUserAliasstring 예
$.oneOf[0].allOf[0].RequestPathstring | null 예
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" 예
$.oneOf[0].allOf[0].ResponseCodeinteger 예
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring 아니요
$.oneOf[0].allOf[1]object 예
$.oneOf[0].allOf[1].Payloadobject 예
$.oneOf[0].allOf[1].Payload.attemptstring 예
$.oneOf[0].allOf[1].Payload.expiresAtinteger 예
$.oneOf[0].allOf[1].Payload.serverTimeinteger 예
$.oneOf[0].allOf[1].Payload.flowstring ["listing","bid"] 예
$.oneOf[0].allOf[1].Payload.resumeURLstring 예
$.oneOf[0].allOf[1].Payload.clientSecretstring 예
$.oneOf[0].allOf[1].Payload.paymentIntentIDstring 예
$.oneOf[0].allOf[1].Payload.paymentStatestring ["requires_payment_method","requires_confirmation","requires_action","processing","requires_capture","canceled","succeeded"] 예
$.oneOf[0].allOf[1].Payload.amountinteger 예Total payable USD cents including the applicable publishing fee.
$.oneOf[1]object 예
$.oneOf[1].RequestUserAliasstring 예
$.oneOf[1].RequestPathstring | null 예
$.oneOf[1].RequestStatus = "Failed" 예
$.oneOf[1].ResponseCodeinteger 예
$.oneOf[1].ResponseMessageAPIResponseMessage 예
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[1].ResponseMessage.oneOf[1]array 예
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[1].ResponseMessage.oneOf[2]object 예
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[1].RequestImpersonatedByUserAliasstring 아니요
응답 예제 
{
    "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
    }
}
기계가 읽을 수 있는 엔드포인트 문서