모든 작업 나열

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

다양한 데이터 형식에서 지정된 데이터 범위/전송/보고서에 대한 모든 트랜잭션 정보를 가져옵니다. API의 응답으로 JSON, CSV 또는 XLS이 반환됩니다.

주의

이 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 형식으로 시작하는 기간. limit 매개 변수가 전달되면 필요하지 않습니다.

Example: datetime_from=2023-02-08

datetime_to

required

string <datetime>

YYYY-MM-DD 형식으로 끝나는 기간. limit 매개 변수가 전달되면 필요하지 않습니다. datetime_from와 datetime_to 사이의 차이는 92일을 초과할 수 없습니다.

Example: datetime_to=2023-03-08

in_transfer_currency

required

integer

모든 재무 데이터를 지급액 통화(기본값은 결제 통화)로 가져옵니다.

show_total

required

boolean

파일 끝에 합계 값 행을 추가할지 여부를 나타냅니다.

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,
"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": "a.smith",
"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
}
}
}
]