모든 작업 나열

Xsolla Developers

또는

모든 작업 나열Server-sideAdmin

get/merchants/{merchant_id}/reports/transactions/registry.{format}

지정된 기간 동안의 성공 및 취소된 트랜잭션에 대한 세부 정보 목록을 반환합니다. 이에 대한 응답으로 수수료, 세금, 주문 및 사용자에 대한 데이터를 포함한 결제 관련 정보를 얻을 수 있습니다. JSON 또는 CSV 형식으로 목록을 가져올 수 있습니다. 이 API 호출을 사용하여 재정 조정을 수행할 수 있습니다.

주의

이 API 호출에는 project_id 경로 매개 변수가 포함되어 있지 않으므로 회사의 모든 프로젝트에서 유효한 API 키를 사용하여 인증을 설정해야 합니다.

SecuritybasicAuth

Request

path Parameters

merchant_id required	integer 판매자 ID입니다.
format required	string 데이터 형식 Enum: "json" "csv" "xls"

query Parameters

datetime_from

required

string <datetime>

기간은 YYYY-MM-DD 형식으로 시작합니다. 다음 매개 변수 중 하나 이상이 전달되는 경우 필요하지 않습니다:

transfer_id
report_id

Example: datetime_from=2023-02-08

datetime_to

required

string <datetime>

기간은 YYYY-MM-DD 형식으로 끝납니다. 다음 매개 변수 중 하나 이상이 전달되는 경우 필요하지 않습니다:

transfer_id
report_id

datetime_from와(과) datetime_to 사이의 차이는 92일을 초과할 수 없습니다.

Example: datetime_to=2023-03-08

in_transfer_currency

required

integer

모든 재무 데이터를 지급 통화로 변환합니다(기본적으로 지급 통화가 사용됨). 다음 매개 변수 중 하나 이상이 전달되는 경우 필요하지 않습니다:

transfer_id
report_id

show_total

boolean

보고서에 총 거래 금액을 포함할지 여부입니다. CSV 형식으로만 내보낼 수 있습니다. 기본값은 true입니다.

merchant_of_records

string or null

머천트 오브 레코드. xsolla 혹은 merchant 이거나 명시되지 않음. merchant인 경우, 파트너의 게이트웨이를 통한 거래를 반환합니다. xsolla인 경우에는, 파트너의 게이트웨이를 거치지 않은 거래를 반환합니다. 명시되지 않은 경우에는, 모든 거래를 반환합니다.

Enum:	Description
merchant	파트너의 게이트웨이를 통한 거래를 반환합니다.
xsolla	파트너의 게이트웨이를 거치지 않은 거래를 반환합니다.

project_id

integer

프로젝트 ID.

show_dry_run

boolean

테스트 트랜잭션을 포함할지 여부를 나타냅니다.

transfer_id

integer

트랜잭션 전송 ID입니다.

report_id

integer

재무 보고서 ID입니다.

offset

integer

목록이 생성된 요소 개수(개수는 0부터 시작함).

limit

integer

페이지에 표시되는 트랜잭션 수에 대한 제한. 이 매개 변수가 전달되면 datetime_from 및 datetime_to 매개 변수를 전달할 필요가 없습니다.

status

string

트랜잭션의 상태입니다.

Enum: "done" "canceled" "error"

Responses

200

거래 목록이 성공적으로 반환되었습니다.

Request samples

Response samples

application/json

[{"payment_details": {"chargebackPenalty": {"amount": 0
},
"commission_agent": {"amount": 0,
"percent": 0
},
"commission_agent_fixed": 0,
"commission_ps": {"amount": 0,
"fixed_amount": 0,
"percent": 0
},
"commission_ps_from_vat": {"amount": 0
},
"commission_user": {"amount": 0.01,
"percent": 33.33
},
"commission_xsolla": {"amount": 0,
"fixed_amount": 0,
"percent": 5
},
"cpa_network_commission": {"amount": 0,
"percent": 0
},
"direct_wht": {"amount": 0,
"percent": 0
},
"payment": {"amount": 0.03,
"amount_from_ps": 0,
"currency": "USD"
},
"payout": {"amount": 0.02,
"amount_from_ps": 0,
"currency": "RUB",
"fx_rate": 64.1386407767,
"percent": 100
},
"refundPenalty": {"amount": 0
},
"repatriation_costs": {"amount": 0,
"percent": 0
},
"sales_tax": {"amount": 0,
"percent": 0
},
"vat": {"amount": 0,
"percent": 0,
"user_amount": 0,
"user_percent": 0
}
},
"purchase": {"friend": {"email": null,
"user_id": null
},
"items_amount": 1,
"pin_codes": {"amount": null,
"content": null,
"currency": null
},
"purchase_amount": 0.02,
"simple_checkout": {"amount": null,
"currency": null
},
"subscription": {"name": null,
"plan_id": null,
"product_id": null,
"product_name": null,
"subscription_id": null
},
"virtual_currency": {"amount": 0.02,
"currency": "USD"
},
"virtual_currency_amount": 1,
"virtual_items": {"amount": null,
"content": null,
"currency": null
}
},
"transaction": {"custom_parameters": null,
"direct_account": 0,
"dry_run": 0,
"external_id": null,
"id": 418756634,
"payment_method": {"class": "Digital Payment Methods",
"id": 2760,
"name": "Your Balance"
},
"project": {"id": 21092,
"name": "Smith"
},
"refund_reason": null,
"refund_reason_comment": null,
"status": "done",
"transfer_date": "2019-02-11T13:32:00+03:00"
},
"user": {"country": "US",
"custom": null,
"email": "email@example.com",
"id": "smith123",
"ip": "209.11.22.33",
"marketplace": "Pay Station",
"name": "Tom",
"phone": null
},
"user_balance": {"payment_currency": {"deduction_amount": 0,
"payout_amount_from_balance": 0.02,
"purchase_amount_from_balance": 0.02
}
}
}
]