선불 계정 잔액 관리

현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동 정보

선불 계정의 잔액을 관리하는 방법은 다음과 같습니다.

• 현재 선불 계정의 잔액을 확인합니다. API를 사용하여 선불 계정 잔액 보기를 참고하세요.
• Worldpay와 같은 서드 파티 결제 시스템 공급자를 사용하여 필요에 따라 계정 잔액을 새로고침합니다 (금액 추가). 타사 결제 시스템 공급자를 통한 선불 잔액 관리를 참조하세요.

  또는 선불 잔액 수동 관리에 설명된 대로 수동으로 또는 통합 결제 시스템을 통해 결제를 추적한 후 수익 창출 API를 호출하여 계정을 새로고침하여 새로고침을 관리할 수 있습니다.

• 수익 창출 API 및 타사 결제 시스템(예: Worldpay)을 사용하여 선불 계정 잔액이 특정 기준액 미만으로 떨어지면 자동 새로고침을 설정합니다. 이 옵션은 요금제의 반복 결제를 관리하는 데 유용합니다. 자세한 내용은 API를 사용하여 선불 계정 잔액 자동 새로고침 설정을 참조하세요.

선불 계정의 잔액은 어떻게 계산하나요?

다음 섹션에 설명된 대로 개발자나 회사의 선불 계정 잔액을 확인하려면 응답에서 다음 값을 가져와야 합니다.

• amount: 현재 결제 기간에 사용할 수 있는 총금액입니다. 이 값은 이 섹션에 설명된 방법을 사용하여 선불 계정을 새로고침하면 업데이트됩니다.
• usage: 현재 결제 기간 동안 사용된 총금액입니다. 이 값은 자격을 갖춘 각 수익 창출 거래와 함께 또는 크레딧을 발급 (양수 또는 음수)하여 업데이트됩니다.

amount 값에서 usage 값을 빼서 현재 결제 기간의 선불 계정 잔액을 계산할 수 있습니다. 예를 들어 amount 값이 335.50이고 usage 값이 34인 경우 잔액은 다음과 같이 계산됩니다.

amount(335.50) - usage(34) = 229.50

API를 사용하여 선불 계정 잔액 보기

다음 섹션에서는 API를 사용하는 개발자나 회사의 선불 계정 잔액을 확인하는 방법을 설명합니다.

개발자를 위한 선불 계정 잔액 보기

개발자의 선불 계정 잔액을 보려면 다음 API 중 하나로 GET 요청을 실행하세요. 여기서 {developer_id}는 개발자의 이메일 주소입니다.

• /mint/organizations/{org_name}/developers/{developer_id}/developer-balances: 개발자를 위한 선불 계정 잔액과 반복 설정 정보를 반환합니다.
• /mint/organizations/{org_name}/developers/{developer_id}/prepaid-developer-balances: 현재 및 총 잔액, 사용량, 충전, 사용세를 포함한 선불 계정 잔액 정보를 반환합니다.

다음 쿼리 매개변수를 전달하여 결과를 필터링할 수 있습니다.

예를 들면 다음과 같습니다.

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/{developer_id}/developer-balances" \
-u email:password

다음은 응답의 예시입니다.

{
    "developerBalance": [
        {
            "amount": 2005,
            "chargePerUsage": false,
            "id": "your-provider-id",
            "isRecurring": false,
            "supportedCurrency": {
                "description": "United States Dollars",
                "displayName": "United States Dollars",
                "id": "usd",
                "name": "USD",
                "organization": {
                    "address": [
                        {
                            "address1": "10 Almaden Blvd.",
                            "city": "San Jose",
                            "country": "US",
                            "id": "32e808d8-3a3c-4d76-a0ae-17d70a982c61",
                            "isPrimary": true,
                            "state": "CA",
                            "zip": "95113"
                        }
                    ],
                    "approveTrusted": false,
                    "approveUntrusted": false,
                    "billingCycle": "CALENDAR_MONTH",
                    "country": "US",
                    "currency": "USD",
                    "description": "my-org",
                    "groupOrganization": false,
                    "hasBillingAdjustment": false,
                    "hasBroker": false,
                    "hasSelfBilling": false,
                    "hasSeparateInvoiceForProduct": false,
                    "id": "my-org",
                    "issueNettingStmt": false,
                    "name": "my-org",
                    "nettingStmtPerCurrency": false,
                    "selfBillingAsExchOrg": false,
                    "selfBillingForAllDev": false,
                    "separateInvoiceForFees": false,
                    "status": "ACTIVE",
                    "supportedBillingType": "BOTH",
                    "taxModel": "HYBRID",
                    "timezone": "UTC"
                },
                "status": "ACTIVE",
                "virtualCurrency": false
            },
            "usage": 2.1572
        }
    ],
    "totalRecords": 1
}

회사의 선불 계정 잔액 보기

회사의 선불 계정 잔액을 보려면 /mint/organizations/{org_name}/companies/{company_id}/developer-balances에 GET 요청을 실행합니다. 여기서 {company_id}는 회사 ID입니다. 회사가 선불인 경우 요청은 현재 선불 계정 잔액을 가져옵니다. 후불 결제인 경우에는 요청에서 현재 신용 한도를 검색합니다.

다음 쿼리 매개변수를 전달하여 결과를 필터링할 수 있습니다.

예를 들면 다음과 같습니다.

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/companies/{company_id}/developer-balances" \
-u email:password

응답은 위에 표시된 응답과 비슷합니다. 여기서 개발자의 선불 계정 잔액을 볼 수 있습니다.

결제 시스템 공급자를 통한 선불 계정 잔액 관리

Worldpay와 같은 서드 파티 결제 시스템 공급자로 판매자 계정을 설정하여 선불 계정 잔액을 관리합니다. 다음 그림은 Worldpay 결제 제공업체를 통해 선불 계정 잔액을 관리하는 방법을 보여줍니다.

다음 표에서는 위에 나온 선불 계정 잔액 관리 흐름의 각 단계를 설명합니다.

{
    "isRecurring": "false",
    "orderCode": "1234",
    "referenceId": "3042815493",
    "referenceUrl": "https://secure.worldpay.com/wcc/dispatcher?OrderKey=MERCH_CODE_FROM_PROVIDER%5E1234",
    "success": "true"
}

다음 섹션에서는 서드 파티 결제 시스템 공급자를 통해 선불 잔액을 관리하는 데 필요한 단계를 설명합니다.

• Worldpay 결제 시스템 공급자로 판매자 계정 설정
• Edge에서 결제 시스템 공급자 구성
• 조직에 구성된 결제 시스템 공급자 보기
• 개발자 포털에서 필수 모듈 사용 설정 및 구성
• 결제 제공업체를 통해 선불 계정에 결제 시작
• API를 사용하여 선불 계정 잔액 다시 로드하기
• 서드 파티 결제 시스템 공급자 삭제

Worldpay 결제 시스템 공급자로 판매자 계정 설정

시작하기 전에 서드 파티 결제 시스템 공급자(Worldpay)에 문의하여 판매자 계정을 설정해야 합니다. 테스트용 계정과 프로덕션용 계정 두 개를 설정하는 것이 좋습니다. Worldpay 판매자 계정에 대한 자세한 내용은 www.worldpay.com 및 wp-support.crm.worldpay.com (Worldpay 지원 센터)을 참조하세요.

판매자 계정을 설정하고 계정 사용자 인증 정보를 받은 후 Worldpay로 판매자 계정을 구성합니다.

1. https://secure.worldpay.com/sso/public/auth/login.html로 이동합니다.
2. Worldpay에서 제공한 사용자 인증 정보를 사용하여 Worldpay 계정에 로그인합니다.
3. XML 비밀번호와 메시지 인증 코드 (MAC) 보안 비밀 키를 설정합니다.
   1. 프로필을 클릭합니다.
   2. XML 비밀번호 필드에서 Edge에서 Worldpay 결제 제공업체를 구성할 때 사용할 비밀번호를 설정합니다.
   3. MAC 보안 비밀 리디렉션 필드에 20~30자(영문 기준)의 MAC 보안 비밀번호 키를 입력합니다.
   4. 프로필 저장을 클릭합니다.
4. 판매자 IP 목록 (허용 목록)에 Apigee Edge 관리 서버를 추가합니다.
   1. 프로필 > 판매자 환경을 클릭합니다.
   2. 새 테스트 IP를 클릭합니다.
   3. Apigee Edge 관리 서버의 IP를 입력하세요.
   4. 저장을 클릭합니다.
5. 메서드 인증 코드 (MAC)를 포함하여 Worldpay 매개변수를 추가하도록 판매자 URL을 구성합니다.
   1. 설치 > 호스팅된 결제 페이지 > 결제 페이지 디자이너를 클릭합니다.
   2. 결제 페이지 수정의 채널 선택 드롭다운 목록에서 설치 ID를 선택합니다.
   3. '속성' 탭에서 판매자 구성 수정을 선택합니다.
   4. URL 매개변수 전송 값을 True로 설정합니다.
   5. 게시 탭을 클릭합니다.
   6. 다음과 같이 변경사항을 승격합니다.
      • 테스트 환경의 경우 Design에서 Promote를 클릭하여 Design에서 샌드박스로 승격합니다.
      • 프로덕션 환경의 경우 샌드박스에서 승급을 클릭하여 샌드박스에서 프로덕션으로 승격합니다.

Edge에서 결제 시스템 공급자 구성

다음 단계는 Edge에서 결제 시스템 공급자를 구성하는 것입니다.

다음 API를 사용하여 특정 조직의 결제 시스템 공급자를 구성할 수 있습니다.

/organizations/{org-name}/providers

시스템 관리자 권한이 있는 Apigee Edge Private Cloud 고객 전용은 선택적으로 다음 API를 사용하여 글로벌 결제 제공업체를 구성할 수 있습니다.

/config/providers

각 API를 호출할 때 요청 본문에 다음 정보를 지정해야 합니다.

예를 들어 다음은 Worldpay-myorg라는 Worldpay를 사용하는 판매자 계정을 설정하는 것입니다.

$ curl  -H "Content-Type:application/json" -X POST -d \
'{
    "name": "Worldpay-myorg",
    "description": "Worldpay payment provider",
    "endpoint": "https://secure.worldpay.com/jsp/merchant/xml/paymentService.jsp",
    "authType": "123456",
    "credential": "dXNlcm5hbWU6cGFzc3dvcmQ=",
    "merchantCode": "myMerchantCode"
  }' \
"https://api.enterprise.apigee.com/v1/organizations/myOrg/providers" \
-u email:password 

타사 결제 시스템 공급자 보기

다음 리소스에 GET 요청을 실행하여 Edge 조직에 구성된 타사 결제 제공업체를 보고 확인합니다.

/mint/organizations/{org-name}/providers

예를 들어 다음은 현재 myorg에 구성된 서드 파티 결제 제공업체를 표시합니다.

$ curl  -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/myorg/providers" \
-u email:password

다음은 두 개의 판매자 계정(테스트용 및 프로덕션용)을 보여주는 응답의 예를 제공합니다.

{
  "provider" : [ {
    "authType" : "123456",
    "credential" : "dXNlcm5hbWU6cGFzc3dvcmQ=",
    "description" : "Worldpay payment provider",
    "endpoint" : "https://secure.worldpay.com/jsp/merchant/xml/paymentService.jsp",
    "id" : "worldpay-myorg",
    "merchantCode" : "MERCH_CODE",
    "name" : "Worldpay-myorg"
  }, {
    "authType" : "123456",
    "credential" : "dXNlcm5hbWU6cGFzc3dvcmQ=",
    "description" : "Worldpay payment provider",
    "endpoint" : "https://secure-test.worldpay.com/jsp/merchant/xml/paymentService.jsp",
    "id" : "worldpay-test",
    "merchantCode" : "MERCH_CODE_FROM_PROVIDER",
    "name" : "Worldpay-test"
  } ]
}

개발자 포털에서 수익 창출 및 Worldpay 모듈 사용 설정 및 구성

개발자 포털에서 필수 수익 창출 및 Worldpay 모듈을 사용 설정합니다. 자세한 내용은 개발자 포털에서 수익 창출 구성을 참고하세요.

결제 시스템 공급자를 통해 선불 계정에 결제 시작

선불 계정 관리 흐름의 2단계에 나와 있는 것처럼, API 소비자가 다음을 수행할 때 개발자 포털에서 결제 시스템 공급자를 통한 선불 계정에 대한 결제가 시작됩니다.

• 요금제를 수락하지만 선불 계정에 잔액이 부족합니다.
• 선불 계정에 금액 충전을 요청합니다.

API를 사용하여 서드 파티 결제 시스템 공급자로부터 결제를 시작하려면 다음 리소스에 POST 요청을 실행합니다. 여기서 {developer_id}는 개발자의 이메일 주소입니다.

/mint/organizations/{org_name}/developers/{developer_id}/payment?amount={amount}&provider={providerId}&supportedCurrencyId={currency}

요청을 실행할 때 다음 값을 쿼리 매개변수로 지정해야 합니다.

• 선불 계정 잔액에 추가할 금액 (amount={amount})
• 결제 시스템 공급자 ID (provider={providerId})
• 지원되는 통화 (supportedCurrencyId={currency})

또한 회사의 청구서 수신 주소와 같은 기본적인 계정 세부정보를 전달해야 합니다.

예를 들어 다음은 Worldpay 결제 제공업체를 사용하여 선불 계정 잔액을 다시 로드하는 예입니다. 선불 계정으로의 최초 이체 금액은 미화 10달러입니다 (amount 쿼리 매개변수가 10로 설정됨).

$ curl  -H "Content-Type:application/xml" -X POST -d \
'{
    "address1": "5115 Hopyard Ave.",
    "city": "Pleasanton",
    "country": "US",
    "state": "CA",
    "zip": "58158"
}'
' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/{developer_id}/payment?amount=10&provider=worldpay-myorg&supportedCurrencyId=usd" \
-u email:password

다음은 응답의 예시입니다.

{
    "isRecurring": "false",
    "orderCode": "1234",
    "referenceId": "3042815493",
    "referenceUrl": "https://secure.worldpay.com/wcc/dispatcher?OrderKey=MERCH_CODE_FROM_PROVIDER%5E1234",
    "success": "true"
}

Worldpay Secure Payment 페이지의 URL이 고유 주문 키와 쿼리 매개변수로 추가된 referenceUrl에서 반환됩니다.

API를 사용하여 선불 계정 잔액 다시 로드

선불 계정 관리 흐름의 15단계에 나와 있는 것처럼 결제 시스템 공급자의 처리가 완료되면 개발자 포털이 Edge에 요청을 전송하여 선불 계정을 다시 로드합니다.

다음 섹션에 설명된 대로 개발자나 회사의 API를 사용하여 선불 계정 잔액을 다시 로드할 수 있습니다.

개발자를 위해 선불 계정 잔액 다시 로드

API를 사용하는 개발자의 선불 계정 잔액을 다시 로드하려면 /mint/organizations/{org_name}/developers/{developer_id}/developer-balances에 POST 요청을 실행합니다. 여기서 {developer_id}는 개발자의 이메일 주소입니다. 요청을 발행할 때 잔액에 추가할 금액과 사용되는 통화를 요청 본문에 지정해야 합니다.

예를 들어 다음 요청은 개발자의 선불 계정 잔액에 $1, 000를 추가합니다.

$ curl -H "Content-Type:application/json" -X POST -d \
'{
  "amount": 1000,
  "supportedCurrency": {
      "id": "usd" 
  } 
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/{developer_id}/developer-balances" \
-u email:password

요청 속성에 대한 설명은 선불 계정 새로고침을 위한 요청 속성 요약을 참조하세요.

회사의 선불 계정 잔액 다시 로드

API를 사용하는 회사의 선불 계정 잔액을 다시 로드하려면 /mint/organizations/{org_name}/companies/{company_id}/developer-balances에 POST 요청을 실행합니다. 여기서 {company_id}는 회사 ID입니다. 요청을 발행할 때 잔액에 추가할 금액과 사용되는 통화를 요청 본문에 지정해야 합니다.

예를 들어 다음 요청은 회사의 선불 계정 잔액에 1, 000달러를 추가합니다.

$ curl -H "Content-Type:application/json" -X POST -d \
'{
  "amount": 1000,
  "supportedCurrency": {
      "id": "usd" 
  } 
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/companies/{company_id}/developer-balances" \
-u email:password

요청 속성에 대한 설명은 선불 계정 새로고침을 위한 요청 속성 요약을 참조하세요.

선불 계정을 다시 로드하기 위한 요청 속성 요약

API를 사용하여 선불 계정 잔액을 다시 로드할 때는 다음 속성을 지정해야 합니다.

서드 파티 결제 시스템 삭제

다음 리소스에 DELETE 요청을 실행하여 에지 조직에 구성된 서드 파티 결제 제공업체를 삭제할 수 있습니다.

특정 조직의 결제 시스템 공급자를 삭제하려면 다음 API를 사용합니다.

/mint/organizations/{org-name}/providers/id

시스템 관리자 권한이 있는 Apigee Edge Private Cloud 고객 전용은 선택적으로 다음 API를 사용하여 글로벌 결제 제공업체를 삭제할 수 있습니다.

/config/providers/id

예를 들어 다음은 현재 myorg에 구성된 타사 결제 제공업체를 삭제합니다.

$ curl  -X DELETE \
"https://api.enterprise.apigee.com/v1/mint/organizations/myorg/providers/worldpay-myorg" \
-u email:password

선불 계정 잔액 수동 관리

또는 API를 사용하여 선불 계정 잔액 다시 로드하기에 설명된 대로 결제를 수동으로 추적하거나 통합 결제 시스템을 통해 결제한 다음 수익 창출 API를 호출하여 계정을 새로고침하여 선불 잔액의 충전을 관리할 수 있습니다.

API를 사용하여 선불 계정 잔액 자동 새로고침 설정

다음 섹션에서는 서드 파티 결제 시스템 공급자를 사용하는 개발자나 회사를 위해 선불 계정 잔액을 자동으로 다시 로드하도록 설정하는 방법을 설명합니다. 이 옵션은 요금제의 반복 결제를 관리하는 데 유용합니다.

개발자를 위해 선불 계정 잔액 자동 새로고침 설정

잔액이 특정 기준 아래로 떨어질 때 개발자를 위해 선불 계정 잔액을 자동으로 새로고침하도록 설정하려면 /mint/organizations/{org_name}/developers/{developer_id}/developer-balances/recurring-setup에 POST 요청을 실행합니다. 여기서 {developer_id}는 개발자의 이메일 주소입니다.

요청을 보낼 때 다음 사항을 지정해야 합니다.

• 계정을 새로고침하는 데 사용할 결제 시스템 공급자의 ID (providerID)
• 자동 새로고침을 사용 설정하는 플래그 (isRecurring)
• 자동 새로고침을 트리거하려면 선불 계정 잔액이 아래로 낮아야 하는 기준액 (replenishAmount)입니다.
• 계정에 자동으로 추가할 금액 (recurringAmount)
• supportedCurrencyID 쿼리 매개변수를 사용하여 통화를 지정합니다.

다음 예에서는 개발자의 선불 계정 잔액이 5달러(미국 달러) 미만으로 떨어지면 10달러(USD)가 계정에 자동으로 추가됩니다.

$ curl -H "Content-Type:application/json" -X POST -d \
'{
    "providerId": "worldpay-myorg",
    "isRecurring" : true,
    "replenishAmount" : 5,
    "recurringAmount" : 10
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/{developer_id}/developer-balances/recurring-setup?supportedCurrencyId=usd" \
-u email:password

요청 속성에 대한 설명은 선불 계정 자동 새로고침을 설정하기 위한 요청 속성 요약을 참조하세요.

회사의 선불 계정 잔액 자동 충전 설정

잔액이 특정 금액 미만으로 떨어질 때 회사의 선불 계정 잔액을 자동으로 새로고침하도록 설정하려면 /mint/organizations/{org_name}/companies/{company_id}/developer-balances/recurring-setup에 POST 요청을 실행합니다. 여기서 {company_id}는 회사 ID입니다.

요청을 보낼 때 다음 사항을 지정해야 합니다.

• 계정을 새로고침하는 데 사용할 결제 시스템 공급자의 ID (providerID)
• 자동 새로고침을 사용 설정하는 플래그 (isRecurring)
• 자동 새로고침을 트리거하려면 선불 계정 잔액이 아래로 낮아야 하는 기준액 (replenishAmount)입니다.
• 계정에 자동으로 추가할 금액 (recurringAmount)
• supportedCurrencyID 쿼리 매개변수를 사용하여 통화를 지정합니다.

다음 예에서는 회사의 선불 계정 잔액이 5달러(미국 달러) 아래로 떨어지면 10달러(미국 달러)가 계정에 자동으로 추가됩니다.

$ curl -H "Content-Type:application/json" -X POST -d \
'{
    "providerId": "worldpay-myorg",
    "isRecurring" : true,
    "replenishAmount" : 5,
    "recurringAmount" : 10
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/companies/{company_id}/developer-balances/recurring-setup?supportedCurrencyId=usd" \
-u email:password

요청 속성에 대한 설명은 선불 계정 자동 새로고침을 설정하기 위한 요청 속성 요약을 참조하세요.

선불 계정의 자동 새로고침을 설정하기 위한 요청 속성 요약

API를 사용하여 선불 계정 잔액을 자동으로 다시 로드할 때 다음 속성을 지정할 수 있습니다.

WorldPay의 호스팅된 결제 페이지로 이전

WorldPay는 호스팅된 결제 페이지라는 새로운 페이지 집합을 사용하도록 보안 결제 처리 흐름을 업데이트했습니다.

지원 중단된 보안 결제 처리 흐름을 사용하여 WorldPay 결제 시스템 공급자를 구성한 경우(2017년 8월 이전) 2018년 1월 이전에 WorldPay의 새로운 호스팅 결제 페이지로 이전해야 합니다.

WorldPay의 호스팅된 결제 페이지로 이전하는 방법:

1. 새로운 호스팅 결제 페이지를 사용하도록 현재 계정을 이전하고 계정의 새 설치 ID를 받으려면 WorldPay에 문의하세요.
2. Edge에서 결제 시스템 공급자 구성에 설명된 대로 새 WorldPay 결제 시스템 공급자를 구성하여 authType 필드에 설치 ID를 전달합니다.
3. 개발자 포털에서 수익 창출 구성에 설명된 대로 개발자 포털에서 새 결제 시스템 공급자를 구성합니다.
4. 결제 시스템 공급자를 통해 선불 계정의 자동 새로고침을 설정하는 경우 API를 사용하여 선불 계정 잔액 자동 새로고침 설정에 설명된 대로 새 제공업체 ID를 사용하도록 자동 새로고침을 다시 구성해야 합니다.

다음 단계

개인 후불 개발자에 대한 크레딧 한도를 설정할 수 있습니다. 후불 잔액 관리에서 방법을 알아보세요.