מדריך API של account | AppointmentTrader

חיפוש בכל נקודות הקצה

/v1/account/

Manages Access to the AppointmentTrader Account

GET

/v1/account/get_incoming_payment_session

Returns details of the incoming payment session and information on whether it has been completed or is still pending.

פרמטרים

שם	סוג	חובה	ברירת מחדל	תיאור
`uniquePaymentSessionID`	`string`	`כן`	`—`	unique session id returned by /v1/account/set_start_incoming_payment_session

דוגמת בקשה (cURL)

curl --get \
  'https://he.appointmenttrader.com/v1/account/get_incoming_payment_session' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'uniquePaymentSessionID={{uniquePaymentSessionID}}'

ערך מוחזר

JSON

See the shared response schema and synthetic example.

שדות התגובה

שדה	סוג	חובה	תיאור
`$`	`account_get_incoming_payment_session_Response`	`כן`
`$.oneOf[0]`		`כן`
`$.oneOf[0].allOf[0]`	`object`	`כן`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`כן`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`כן`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`כן`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`כן`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`כן`
`$.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].RequestImpersonatedByUserAlias`	`string`	`לא`
`$.oneOf[0].allOf[1]`	`object`	`כן`
`$.oneOf[0].allOf[1].Payload`	`object`	`כן`
`$.oneOf[0].allOf[1].Payload.Name`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.MetaInformation`	`array`	`כן`
`$.oneOf[0].allOf[1].Payload.MetaInformation[]`	`string`	`לא`
`$.oneOf[0].allOf[1].Payload.KeyValueList`	`array`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[]`	`object`	`לא`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].uniquePaymentSessionID`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].createDate`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].lastUpdateDate`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].expiryDate`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].sessionStatus`	`string ["active","expired"]`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].paymentType`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].remainingSessionLifetimeInSeconds`	`DatabaseInteger`	`כן`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.KeyValueList[].remainingSessionLifetimeInSeconds.oneOf[0]`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].remainingSessionLifetimeInSeconds.oneOf[1]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].userAlias`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].transactionReferenceID`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].transactionDescription`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].grossAmount`	`DatabaseInteger`	`כן`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.KeyValueList[].grossAmount.oneOf[0]`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].grossAmount.oneOf[1]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].discountedAmount`	`DatabaseInteger`	`כן`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.KeyValueList[].discountedAmount.oneOf[0]`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].discountedAmount.oneOf[1]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].paymentDetails`		`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].paymentDetails.anyOf[0]`	`object`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].paymentDetails.anyOf[0].DestinationAccount`	`string`	`לא`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].paymentDetails.anyOf[0].*`	`PaymentConfigurationValue`	`לא`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].paymentDetails.anyOf[0].*.oneOf[0]`	`string \| number \| boolean \| null`	`לא`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].paymentDetails.anyOf[0].*.oneOf[1]`	`array`	`לא`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].paymentDetails.anyOf[0].*.oneOf[1][]`	`PaymentConfigurationValue`	`לא`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].paymentDetails.anyOf[0].*.oneOf[2]`	`object`	`לא`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].paymentDetails.anyOf[0]..oneOf[2].`	`PaymentConfigurationValue`	`לא`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].paymentDetails.anyOf[1]`	`array`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].paymentDetails.anyOf[1][]`	`PaymentConfigurationValue`	`לא`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].paymentDetails.anyOf[1][].oneOf[0]`	`string \| number \| boolean \| null`	`לא`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].paymentDetails.anyOf[1][].oneOf[1]`	`array`	`לא`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].paymentDetails.anyOf[1][].oneOf[1][]`	`PaymentConfigurationValue`	`לא`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].paymentDetails.anyOf[1][].oneOf[2]`	`object`	`לא`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].paymentDetails.anyOf[1][].oneOf[2].*`	`PaymentConfigurationValue`	`לא`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].paymentDetails.anyOf[2]`	`string \| number \| boolean \| null`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].fundingStatus`	`string ["not_funded","funded"]`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueFieldList`	`array`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueFieldList[]`	`string`	`לא`
`$.oneOf[1]`	`object`	`כן`
`$.oneOf[1].RequestUserAlias`	`string`	`כן`
`$.oneOf[1].RequestPath`	`string \| null`	`כן`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`כן`
`$.oneOf[1].ResponseCode`	`integer`	`כן`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`כן`
`$.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].RequestImpersonatedByUserAlias`	`string`	`לא`

דוגמת תגובה

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/account/get_incoming_payment_session",
    "RequestUserAlias": "example-user",
    "Payload": {
        "Name": "synthetic-example",
        "MetaInformation": [],
        "KeyValueList": [],
        "KeyValueFieldList": []
    }
}

תיעוד נקודת קצה קריא למכונה

GET

/v1/account/get_ledger

Returns paginated ledger entries for one account owned by the acting API user. Admin tools should access another user's ledger through the dispatcher impersonationUserAlias parameter; this endpoint still validates the account against the effective API user.

פרמטרים

שם	סוג	חובה	ברירת מחדל	תיאור
`accountID`	`string`	`כן`	`—`	Account ID owned by the acting API user.
`pageNumber`	`int`	`לא`	`0`	Zero-based page number.
`pageLength`	`int`	`לא`	`50`	Number of ledger rows to return, capped at 200.

דוגמת בקשה (cURL)

curl --get \
  'https://he.appointmenttrader.com/v1/account/get_ledger' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'accountID={{accountID}}' \
  --data-urlencode 'pageNumber={{pageNumber}}' \
  --data-urlencode 'pageLength={{pageLength}}'

ערך מוחזר

JSON

See the shared response schema and synthetic example.

שדות התגובה

שדה	סוג	חובה	תיאור
`$`	`account_get_ledger_Response`	`כן`
`$.oneOf[0]`		`כן`
`$.oneOf[0].allOf[0]`	`object`	`כן`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`כן`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`כן`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`כן`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`כן`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`כן`
`$.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].RequestImpersonatedByUserAlias`	`string`	`לא`
`$.oneOf[0].allOf[1]`	`object`	`כן`
`$.oneOf[0].allOf[1].Payload`	`object`	`כן`
`$.oneOf[0].allOf[1].Payload.Account`	`object`	`כן`
`$.oneOf[0].allOf[1].Payload.Account.Currency`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.Account.CurrencySymbol`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.Account.CreatedDate`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.Account.LastUpdateDate`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.Account.Name`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.Account.Description`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.Account.ID`	`DatabaseInteger`	`כן`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.Account.ID.oneOf[0]`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.Account.ID.oneOf[1]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.Account.ATUser_ID`	`DatabaseInteger`	`כן`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.Account.ATUser_ID.oneOf[0]`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.Account.ATUser_ID.oneOf[1]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.Account.CurrencyCreditLimit`	`DatabaseInteger`	`כן`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.Account.CurrencyCreditLimit.oneOf[0]`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.Account.CurrencyCreditLimit.oneOf[1]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.Account.PayoutDefaultBasisPoints`	`DatabaseInteger`	`כן`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.Account.PayoutDefaultBasisPoints.oneOf[0]`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.Account.PayoutDefaultBasisPoints.oneOf[1]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.Account.PointsCreditLimit`	`DatabaseInteger`	`כן`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.Account.PointsCreditLimit.oneOf[0]`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.Account.PointsCreditLimit.oneOf[1]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.Account.IsATCorporateAccount`	`DatabaseInteger`	`כן`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.Account.IsATCorporateAccount.oneOf[0]`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.Account.IsATCorporateAccount.oneOf[1]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.Account.IsDefault`	`DatabaseInteger`	`כן`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.Account.IsDefault.oneOf[0]`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.Account.IsDefault.oneOf[1]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.Account.IsDepositAccount`	`DatabaseInteger`	`כן`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.Account.IsDepositAccount.oneOf[0]`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.Account.IsDepositAccount.oneOf[1]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.Account.CurrencyBalance`	`DatabaseInteger`	`כן`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.Account.CurrencyBalance.oneOf[0]`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.Account.CurrencyBalance.oneOf[1]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.Account.PointsBalance`	`DatabaseInteger`	`כן`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.Account.PointsBalance.oneOf[0]`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.Account.PointsBalance.oneOf[1]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger`	`array`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[]`	`object`	`לא`
`$.oneOf[0].allOf[1].Payload.Ledger[].CreatedDate`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].LastUpdateDate`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].Name`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].Description`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].ConfirmationObject`	`string`	`כן`	Stored provider/audit content is returned as text; it is not decoded into a JSON object by this endpoint.
`$.oneOf[0].allOf[1].Payload.Ledger[].ID`	`DatabaseInteger`	`כן`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.Ledger[].ID.oneOf[0]`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].ID.oneOf[1]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].CurrencyAmount`	`DatabaseInteger`	`כן`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.Ledger[].CurrencyAmount.oneOf[0]`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].CurrencyAmount.oneOf[1]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].PointsAmount`	`DatabaseInteger`	`כן`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.Ledger[].PointsAmount.oneOf[0]`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].PointsAmount.oneOf[1]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].CurrencyBalance`	`DatabaseInteger`	`כן`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.Ledger[].CurrencyBalance.oneOf[0]`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].CurrencyBalance.oneOf[1]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].PointsBalance`	`DatabaseInteger`	`כן`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.Ledger[].PointsBalance.oneOf[0]`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].PointsBalance.oneOf[1]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].Originating-ATAccountsLedger_ID`		`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].Originating-ATAccountsLedger_ID.anyOf[0]`	`DatabaseInteger`	`כן`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.Ledger[].Originating-ATAccountsLedger_ID.anyOf[0].oneOf[0]`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].Originating-ATAccountsLedger_ID.anyOf[0].oneOf[1]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].Originating-ATAccountsLedger_ID.anyOf[1]`	`null`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].Originating-ATAccounts_ID`		`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].Originating-ATAccounts_ID.anyOf[0]`	`DatabaseInteger`	`כן`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.Ledger[].Originating-ATAccounts_ID.anyOf[0].oneOf[0]`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].Originating-ATAccounts_ID.anyOf[0].oneOf[1]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].Originating-ATAccounts_ID.anyOf[1]`	`null`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].Destination-ATAccounts_ID`		`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].Destination-ATAccounts_ID.anyOf[0]`	`DatabaseInteger`	`כן`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.Ledger[].Destination-ATAccounts_ID.anyOf[0].oneOf[0]`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].Destination-ATAccounts_ID.anyOf[0].oneOf[1]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].Destination-ATAccounts_ID.anyOf[1]`	`null`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].ATUserPaymentMethods_ID`		`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].ATUserPaymentMethods_ID.anyOf[0]`	`DatabaseInteger`	`כן`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.Ledger[].ATUserPaymentMethods_ID.anyOf[0].oneOf[0]`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].ATUserPaymentMethods_ID.anyOf[0].oneOf[1]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].ATUserPaymentMethods_ID.anyOf[1]`	`null`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].ConfirmationID`		`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].ConfirmationID.anyOf[0]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].ConfirmationID.anyOf[1]`	`null`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].SupplementalURL`		`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].SupplementalURL.anyOf[0]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].SupplementalURL.anyOf[1]`	`null`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].Stripe-RefundObject`		`כן`	Stored provider/audit content is returned as text; it is not decoded into a JSON object by this endpoint.
`$.oneOf[0].allOf[1].Payload.Ledger[].Stripe-RefundObject.anyOf[0]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].Stripe-RefundObject.anyOf[1]`	`null`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].Stripe-DisputeObject`		`כן`	Stored provider/audit content is returned as text; it is not decoded into a JSON object by this endpoint.
`$.oneOf[0].allOf[1].Payload.Ledger[].Stripe-DisputeObject.anyOf[0]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].Stripe-DisputeObject.anyOf[1]`	`null`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].Checkout-RefundObject`		`כן`	Stored provider/audit content is returned as text; it is not decoded into a JSON object by this endpoint.
`$.oneOf[0].allOf[1].Payload.Ledger[].Checkout-RefundObject.anyOf[0]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].Checkout-RefundObject.anyOf[1]`	`null`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].Checkout-DisputeObject`		`כן`	Stored provider/audit content is returned as text; it is not decoded into a JSON object by this endpoint.
`$.oneOf[0].allOf[1].Payload.Ledger[].Checkout-DisputeObject.anyOf[0]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].Checkout-DisputeObject.anyOf[1]`	`null`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].RefundInstruction`		`כן`	Stored provider/audit content is returned as text; it is not decoded into a JSON object by this endpoint.
`$.oneOf[0].allOf[1].Payload.Ledger[].RefundInstruction.anyOf[0]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].RefundInstruction.anyOf[1]`	`null`	`כן`
`$.oneOf[0].allOf[1].Payload.Ledger[].TransactionType`	`string ["DEBIT","CREDIT"]`	`כן`
`$.oneOf[0].allOf[1].Payload.Page`	`object`	`כן`
`$.oneOf[0].allOf[1].Payload.Page.PageNumber`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.Page.PageLength`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.Page.NextPageNumber`		`כן`
`$.oneOf[0].allOf[1].Payload.Page.NextPageNumber.anyOf[0]`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.Page.NextPageNumber.anyOf[1]`	`null`	`כן`
`$.oneOf[0].allOf[1].Payload.Page.PreviousPageNumber`		`כן`
`$.oneOf[0].allOf[1].Payload.Page.PreviousPageNumber.anyOf[0]`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.Page.PreviousPageNumber.anyOf[1]`	`null`	`כן`
`$.oneOf[0].allOf[1].Payload.Page.HasMore`	`boolean`	`כן`
`$.oneOf[1]`	`object`	`כן`
`$.oneOf[1].RequestUserAlias`	`string`	`כן`
`$.oneOf[1].RequestPath`	`string \| null`	`כן`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`כן`
`$.oneOf[1].ResponseCode`	`integer`	`כן`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`כן`
`$.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].RequestImpersonatedByUserAlias`	`string`	`לא`

דוגמת תגובה

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/account/get_ledger",
    "RequestUserAlias": "example-user",
    "Payload": {
        "Account": {
            "Currency": "synthetic-example",
            "CurrencySymbol": "synthetic-example",
            "CreatedDate": "synthetic-example",
            "LastUpdateDate": "synthetic-example",
            "Name": "synthetic-example",
            "Description": "synthetic-example",
            "ID": 0,
            "ATUser_ID": 0,
            "CurrencyCreditLimit": 0,
            "PayoutDefaultBasisPoints": 0,
            "PointsCreditLimit": 0,
            "IsATCorporateAccount": 0,
            "IsDefault": 0,
            "IsDepositAccount": 0,
            "CurrencyBalance": 0,
            "PointsBalance": 0
        },
        "Ledger": [],
        "Page": {
            "PageNumber": 0,
            "PageLength": 0,
            "NextPageNumber": 0,
            "PreviousPageNumber": 0,
            "HasMore": false
        }
    }
}

תיעוד נקודת קצה קריא למכונה

GET

/v1/account/get_list

Returns all available user accounts including their balances and if applicable credit limits in the smallest possible currency unit

פרמטרים

שם	סוג	חובה	ברירת מחדל	תיאור
`searchFilter`	`string`	`לא`	`""`	filter criteria
`includeDepositAccount`	`bool`	`לא`	`false`	defines if deposit account should be return
`pageSize`	`int`	`לא`	`50`	Defines how many results will be return per request
`pageNumber`	`int`	`לא`	`0`	Defines which page should be returned
`includeCorporateAccounts`	`bool`	`לא`	`false`	Admin-only flag to include corporate accounts owned by the inspected user.
`includeHiddenAccounts`	`bool`	`לא`	`false`	Admin-only flag to include hidden accounts owned by the inspected user.

דוגמת בקשה (cURL)

curl --get \
  'https://he.appointmenttrader.com/v1/account/get_list' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'searchFilter={{searchFilter}}' \
  --data-urlencode 'includeDepositAccount={{includeDepositAccount}}' \
  --data-urlencode 'pageSize={{pageSize}}' \
  --data-urlencode 'pageNumber={{pageNumber}}' \
  --data-urlencode 'includeCorporateAccounts={{includeCorporateAccounts}}' \
  --data-urlencode 'includeHiddenAccounts={{includeHiddenAccounts}}'

ערך מוחזר

JSON

See the shared response schema and synthetic example.

שדות התגובה

שדה	סוג	חובה	תיאור
`$`	`account_get_list_Response`	`כן`
`$.oneOf[0]`		`כן`
`$.oneOf[0].allOf[0]`	`object`	`כן`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`כן`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`כן`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`כן`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`כן`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`כן`
`$.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].RequestImpersonatedByUserAlias`	`string`	`לא`
`$.oneOf[0].allOf[1]`	`object`	`כן`
`$.oneOf[0].allOf[1].Payload`	`object`	`כן`
`$.oneOf[0].allOf[1].Payload.ATResponseObjectType`	`= "NestedKeyValueList"`	`כן`
`$.oneOf[0].allOf[1].Payload.ResponseBody`	`object`	`כן`
`$.oneOf[0].allOf[1].Payload.ResponseBody.Name`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.ResponseBody.MetaInformation`	`array`	`כן`
`$.oneOf[0].allOf[1].Payload.ResponseBody.MetaInformation[]`	`string`	`לא`
`$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList`	`array`	`כן`
`$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[]`	`object`	`לא`
`$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].accountName`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].accountDescription`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].accountCurrency`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].accountCurrencySymbol`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].accountNameAndBalance`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].accountID`	`DatabaseInteger`	`כן`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].accountID.oneOf[0]`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].accountID.oneOf[1]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].accountCurrencyBalance`	`DatabaseInteger`	`כן`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].accountCurrencyBalance.oneOf[0]`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].accountCurrencyBalance.oneOf[1]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].accountPointsBalance`	`DatabaseInteger`	`כן`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].accountPointsBalance.oneOf[0]`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].accountPointsBalance.oneOf[1]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].accountCurrencyCreditLimit`	`DatabaseInteger`	`כן`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].accountCurrencyCreditLimit.oneOf[0]`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].accountCurrencyCreditLimit.oneOf[1]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].accountPointsCreditLimit`	`DatabaseInteger`	`כן`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].accountPointsCreditLimit.oneOf[0]`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].accountPointsCreditLimit.oneOf[1]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].accountIsCorporate`	`DatabaseInteger`	`כן`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].accountIsCorporate.oneOf[0]`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].accountIsCorporate.oneOf[1]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].accountAvailableCurrencyBalance`	`number`	`כן`
`$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].accountAvailablePointsBalance`	`number`	`כן`
`$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueFieldList`	`array`	`כן`
`$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueFieldList[]`	`string`	`לא`
`$.oneOf[1]`	`object`	`כן`
`$.oneOf[1].RequestUserAlias`	`string`	`כן`
`$.oneOf[1].RequestPath`	`string \| null`	`כן`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`כן`
`$.oneOf[1].ResponseCode`	`integer`	`כן`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`כן`
`$.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].RequestImpersonatedByUserAlias`	`string`	`לא`

דוגמת תגובה

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/account/get_list",
    "RequestUserAlias": "example-user",
    "Payload": {
        "ATResponseObjectType": "NestedKeyValueList",
        "ResponseBody": {
            "Name": "synthetic-example",
            "MetaInformation": [],
            "KeyValueList": [],
            "KeyValueFieldList": []
        }
    }
}

תיעוד נקודת קצה קריא למכונה

POST

/v1/account/set_start_incoming_payment_session

Creates an incoming payments session which will be credited to API users main account. The gross amount will be discounted, and the discounted expected payment will be returned

פרמטרים

שם	סוג	חובה	ברירת מחדל	תיאור
`paymentType`	`string`	`כן`	`—`	Type of payment used
`grossAmount`	`int`	`כן`	`—`	Amount that shall be received by the transaction
`transactionReferenceID`	`string`	`כן`	`—`	this reference number can be used to avoid creating new payments sessions for the same checkout flow, if an active payments session for this transactionReferenceID exists the ExpiryTime will extended by the payment types sessionLifetime
`transactionDescription`	`string`	`כן`	`—`	this description will reflect on the users account detailing what the charge was for.
`isWritingRequest`	`bool`	`לא`	`false`	all set_[...] functions have this parameter - if false (which is default) the method will execute without writing any data. Set this parameter to true once you are sure that you tested your logic and want to execute a writing request

דוגמת בקשה (cURL)

curl --request POST \
  'https://he.appointmenttrader.com/v1/account/set_start_incoming_payment_session' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'paymentType={{paymentType}}' \
  --data-urlencode 'grossAmount={{grossAmount}}' \
  --data-urlencode 'transactionReferenceID={{transactionReferenceID}}' \
  --data-urlencode 'transactionDescription={{transactionDescription}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

ערך מוחזר

JSON

See the shared response schema and synthetic example.

שדות התגובה

שדה	סוג	חובה	תיאור
`$`	`account_set_start_incoming_payment_session_Response`	`כן`
`$.oneOf[0]`		`כן`
`$.oneOf[0].allOf[0]`	`object`	`כן`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`כן`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`כן`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`כן`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`כן`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`כן`
`$.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].RequestImpersonatedByUserAlias`	`string`	`לא`
`$.oneOf[0].allOf[1]`	`object`	`כן`
`$.oneOf[0].allOf[1].Payload`	`object`	`כן`
`$.oneOf[0].allOf[1].Payload.Name`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.MetaInformation`	`array`	`כן`
`$.oneOf[0].allOf[1].Payload.MetaInformation[]`	`string`	`לא`
`$.oneOf[0].allOf[1].Payload.KeyValueList`	`array`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[]`	`object`	`לא`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].uniquePaymentSessionID`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].createDate`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].lastUpdateDate`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].expiryDate`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].sessionStatus`	`string ["active","expired"]`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].paymentType`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].remainingSessionLifetimeInSeconds`	`DatabaseInteger`	`כן`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.KeyValueList[].remainingSessionLifetimeInSeconds.oneOf[0]`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].remainingSessionLifetimeInSeconds.oneOf[1]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].userAlias`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].transactionReferenceID`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].transactionDescription`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].grossAmount`	`DatabaseInteger`	`כן`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.KeyValueList[].grossAmount.oneOf[0]`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].grossAmount.oneOf[1]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].discountedAmount`	`DatabaseInteger`	`כן`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.KeyValueList[].discountedAmount.oneOf[0]`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].discountedAmount.oneOf[1]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].paymentDetails`		`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].paymentDetails.anyOf[0]`	`object`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].paymentDetails.anyOf[0].DestinationAccount`	`string`	`לא`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].paymentDetails.anyOf[0].*`	`PaymentConfigurationValue`	`לא`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].paymentDetails.anyOf[0].*.oneOf[0]`	`string \| number \| boolean \| null`	`לא`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].paymentDetails.anyOf[0].*.oneOf[1]`	`array`	`לא`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].paymentDetails.anyOf[0].*.oneOf[1][]`	`PaymentConfigurationValue`	`לא`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].paymentDetails.anyOf[0].*.oneOf[2]`	`object`	`לא`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].paymentDetails.anyOf[0]..oneOf[2].`	`PaymentConfigurationValue`	`לא`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].paymentDetails.anyOf[1]`	`array`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].paymentDetails.anyOf[1][]`	`PaymentConfigurationValue`	`לא`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].paymentDetails.anyOf[1][].oneOf[0]`	`string \| number \| boolean \| null`	`לא`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].paymentDetails.anyOf[1][].oneOf[1]`	`array`	`לא`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].paymentDetails.anyOf[1][].oneOf[1][]`	`PaymentConfigurationValue`	`לא`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].paymentDetails.anyOf[1][].oneOf[2]`	`object`	`לא`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].paymentDetails.anyOf[1][].oneOf[2].*`	`PaymentConfigurationValue`	`לא`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].paymentDetails.anyOf[2]`	`string \| number \| boolean \| null`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].fundingStatus`	`string ["not_funded","funded"]`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueFieldList`	`array`	`כן`
`$.oneOf[0].allOf[1].Payload.KeyValueFieldList[]`	`string`	`לא`
`$.oneOf[1]`	`object`	`כן`
`$.oneOf[1].RequestUserAlias`	`string`	`כן`
`$.oneOf[1].RequestPath`	`string \| null`	`כן`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`כן`
`$.oneOf[1].ResponseCode`	`integer`	`כן`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`כן`
`$.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].RequestImpersonatedByUserAlias`	`string`	`לא`

דוגמת תגובה

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/account/set_start_incoming_payment_session",
    "RequestUserAlias": "example-user",
    "Payload": {
        "Name": "synthetic-example",
        "MetaInformation": [],
        "KeyValueList": [],
        "KeyValueFieldList": []
    }
}

תיעוד נקודת קצה קריא למכונה