다음을 통해 공유

결제 내보내기 요청 만들기

API 엔드포인트에 POST 요청을 제출하여 결제에 대한 새 내보내기 요청을 큐에 대기합니다.

REST 요청

메서드 요청 URI
게시 https://api.partner.microsoft.com/v1.0/payouts/payments?$filter={$filter}&fileformat=csv

요청 매개 변수

이름 안으로 필수 유형 묘사
$filter 쿼리 아니요 문자열 선택적 필터이지만 성능 향상을 위해 필터를 사용하고 지난 3년간의 데이터를 내보내는 대신 내보내기 데이터를 제한하는 것이 좋습니다. 전체 $filter 옵션 집합은 다음 표를 참조하세요.
파일 형식 쿼리 아니요 문자열 지원되는 값은 .csv과 /.tsv입니다. 값이 제공되지 않으면 기본값으로 .csv가 사용됩니다.
이름 묘사 유형 형식
programName 등록한 프로그램 중 하나 이상으로 필터를 설정합니다. 예제 값 - 'CSP 간접 제공자', 'CSP 2T 간접 제공자', 'CSP 직접 청구 파트너', 'CSP 1T 직접 파트너', 'CSP 간접 리셀러', 'CSP 2T 간접 리셀러' 문자열 {baseUrl}/v1.0/payouts/payments?$filter=?$filter=programName=’CSP Indirect Provider’

다양한 요청 매개 변수를 사용한 결제 샘플 필터

“?$filter=payoutStatusUpdateTS le 2019-09-25T23:11:55.647Z and (enrollmentParticipantId eq 'XXXXXXX') and (programName eq 'CSP Direct Bill Partner') and (payoutOrderType eq 'REBATE') and (paymentId eq '000000000000')”

요청 헤더

이름 필수 유형 묘사
권한 부여 예 문자열 권한 부여 전달자 토큰입니다.
ms-correlationid 아니요 문자열 내부 요청 추적기입니다. 각 요청은 새 추적기(GUID)를 생성합니다.
ms-requestid 아니요 문자열 요청의 멱등성 ID입니다.

자세한 내용은 파트너 센터 REST 헤더 참조하세요.

요청 본문

해당 사항 없음

API 응답

HTTP/1.1 202 Accepted

API 응답 페이로드는 다음 특성을 반환합니다.

이름 선택적 묘사
값 거짓 가능한 값과 동작은 다음 표를 참조하세요.
값 클라이언트 작업
요청 ID 내보내기 요청의 요청 ID
요청일시 내보내기 요청의 시작 날짜/시간
요청 경로 내보내기 요청의 쿼리 경로입니다.
요청 쿼리 문자열 내보내기 요청의 일부로 사용되는 필터입니다.
블롭 위치 내보내기 파일이 준비되면 토큰이 있는 Blob 리소스
상태 내보내기 작업 상태입니다. 상태에 대한 가능한 값의 다음 목록을 참조하세요.

상태에 대한 가능한 값

  • 대기: 내보내기 작업이 시작되지 않았습니다.
  • 처리: 내보내기 작업이 진행 중입니다.
  • 실패한: 내보내기 작업이 여러 번의 시도 후에도 실패했습니다. 새 요청을 큐에 등록해 보세요.
  • 완료된: 내보내기 작업이 완료되고 내보내기 파일을 다운로드할 준비가 된 것입니다.

샘플 응답:

{
    "value": [
        {
            "requestId": "93c2b3cf-c6d8-4e7e-ade1-007768a6eba4",
            "requestDateTime": "2023-05-25T21:20:46.3727561Z",
            "requestPath": "/v1.0/payouts/payments",
            "requestQueryString": "paymentDate ge 2023-03-01 and paymentDate le 2023-04-12",
            "blobLocation": "",
            "status": "Queued"
        }
    ],
    "nextLink": null,
    "totalCount": 1
}

API는 HTTP 상태 202를 반환합니다.

이름 묘사
202 수락됨 요청이 수락됩니다. 요청 상태에 대한 GET 요청 URL을 쿼리합니다.

요청에 따라 API는 다른 표준 상태를 반환할 수 있습니다.

이름 묘사
400 잘못된 요청 누락되거나 잘못된 데이터가 있습니다.
401 권한 없음 호출자는 인증되지 않으며 첫 번째 호출을 하기 전에 파트너 API 서비스를 사용하여 인증해야 합니다.
403 금지됨 호출자에게 요청을 할 권한이 없습니다.
500 내부 서버 오류 API 또는 해당 종속성 중 하나가 요청을 처리할 수 없습니다. 나중에 다시 시도하세요.
404 찾을 수 없음 입력 매개 변수와 함께 리소스를 사용할 수 없습니다.
429 속도 제한 동일한 형식의 요청이 너무 많습니다. 잠시 후에 시도해 보세요.
  • Last updated on