모든 트랜잭션 검색

모든 트랜잭션 검색Server-sideAdmin

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

특정 검색 매개 변수를 기준으로 트랜잭션 목록을 반환합니다. 이에 대한 응답으로 성공적으로 완료되지 않았더라도 게임에서 이루어진 모든 결제에 대한 데이터를 얻을 수 있습니다. 트랜잭션 기간뿐만 아니라 특정 사용자 또는 특정 결제 상태의 거래를 검색하는 등 다른 매개 변수도 지정할 수 있습니다. JSON 또는 CSV 형식으로 목록을 가져올 수 있습니다.

주의

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

SecuritybasicAuth

Request

path Parameters

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

query Parameters

datetime_from

string <datetime>

날짜 범위의 시작입니다.

datetime_to

string <datetime>

날짜 범위의 끝입니다.

project_id

integer

프로젝트 ID.

transaction_id

integer

트랜잭션 ID.

type

string

검색 결과에 표시되는 거래 유형:

Enum:	Description
all	모든 거래.
canceled	취소된 거래(테스트 거래 제외).
test	테스트 거래.
transferred	성공한 거래(테스트 거래 제외).

phone

string

게임유저 전화 번호입니다(국제 형식).

user_id

string

귀하 측에 저장된 게임 내 고유 사용자 ID입니다. 기존 사용자 ID여야 합니다. 오류가 발생하면 자주 묻는 질문에 대한 답변을 참조해 주세요.

user_name

string

사용자 이름.

user_custom

string

게임유저 식별을 위한 파라미터를 사용자 지정합니다.

string <= 100 characters

사용자 이메일.

external_id

string

게임의 트랜잭션 ID 입니다. 각 사용자 결제별로 고유해야 합니다.

offset

integer

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

limit

integer

페이지 요소 개수 제한.

status

string

트랜잭션 상태입니다.

Enum:	Description
awaitingRefund	트랜잭션 환불 결정을 기다리고 있습니다. 사용자가 환불을 요청하면 엑솔라 고객 지원팀에서 요청을 수동으로 처리하고 환불을 결정합니다.
canceled	가능한 사례는 다음과 같습니다. 결제 시스템 측에서 거래를 취소했습니다. 예를 들어, 사용자 계정에 잔액이 부족한 경우입니다. 사용자에게 결제 금액이 환불되었습니다.
created	사용자가 트랜잭션을 시작했지만 아직 처리되지 않았습니다.
done	트랜잭션을 성공적으로 처리했습니다.
error	트랜잭션을 처리하는 동안 오류가 발생했습니다. 오류가 발생한 결제 금액은 엑솔라 고객 지원팀에 연락하여 환불받을 수 있습니다.
partiallyRefunded	사용자가 부분 환불을 받았습니다.
processing	트랜잭션을 처리하고 있습니다.
refunded	사용자의 엑솔라 잔액으로 환불이 이루어졌습니다.
review	부정 결제 방지 시스템에 의해 트랜잭션 처리가 일시 중지되었으며 현재 추가로 거래를 확인하고 있습니다.

Responses

200

OK.

Request samples

Response samples

application/json

[{"payment_details": {"payment": {"amount": 7.96,
"amount_from_ps": 7.96,
"currency": "RUB"
},
"sales_tax": {"amount": 0,
"percent": 0
}
},
"payment_system": {"decline_reason": null
},
"purchase": {"pin_codes": {"amount": null,
"content": null,
"currency": null
},
"simple_checkout": {"amount": 7.96,
"currency": "RUB"
},
"subscription": {"name": null
},
"virtual_currency": {"amount": 0,
"name": null
},
"virtual_items": null
},
"transaction": {"create_date": "2021-10-20",
"dry_run": 0,
"external_id": "example-external-id",
"id": 123456789,
"is_refund_allowed": 0,
"payment_method": {"id": 1,
"name": "PayPal"
},
"project": {"id": 123456,
"name": "Example"
},
"refund_reason": null,
"status": "done",
"transfer_date": "2021-10-20"
},
"user": {"country": "RU",
"custom": null,
"email": "email@example.com",
"id": "example-id",
"name": "Example",
"phone": null
}
}
]