결제 내보내기 요청 만들기

아티클
11/13/2024

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

REST 요청

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

요청 매개 변수

이름	그런 다음	필수	Type	설명
$filter	쿼리	아니요	문자열	선택적 필터이지만 성능 향상을 위해 필터를 사용하고 지난 3년간의 데이터를 내보내는 대신 내보내기 데이터를 제한하는 것이 좋습니다. 전체 $filter 옵션 집합은 다음 표를 참조하세요.
fileFormat	쿼리	아니요	문자열	지원되는 값은 .csv/.tsv입니다. 값이 제공되지 않으면 기본적으로 .csv로 설정됩니다.

이름	Description	Type	형식
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')”

요청 헤더

이름	필수	Type	설명
Authorization	예	문자열	권한 부여 전달자 토큰입니다.
ms-correlationid	아니요	문자열	내부 요청 추적기입니다. 각 요청은 새 추적기(GUID)를 생성합니다.
ms-requestid	아니요	문자열	요청 idempotency ID입니다.

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

요청 본문

해당 없음

API 응답

HTTP/1.1 202 Accepted

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

이름	선택 사항	설명
값	false	가능한 값과 동작은 다음 표를 참조하세요.

값	클라이언트 작업
requestId	내보내기 요청의 요청 ID
requestDateTime	내보내기 요청의 시작 날짜/시간
requestPath	내보내기 요청의 쿼리 경로입니다.
requestQueryString	내보내기 요청의 일부로 사용되는 필터입니다.
blobLocation	내보내기 파일이 준비되면 토큰이 있는 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 속도 제한	동일한 형식의 요청이 너무 많습니다. 잠시 후에 시도해 보세요.

다음을 통해 공유