그래프 API
그래프 API 버전

결제 /{payment-id}

Facebook 결제를 사용하여 앱에서 이루어지는 결제의 상세 정보입니다.

읽기

그래프 API 탐색기
GET /v21.0/{payment-id} HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/{payment-id}',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{payment-id}",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{payment-id}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

권한

  • 결제를 만든 앱의 앱 액세스 토큰이 필요합니다.

필드

이름 설명 유형

id

결제 ID입니다.

string

user

사용자 id및 소비자의 성과 이름입니다. 일부 경우에는 생략될 수 있습니다.

User

request_id

JS 함수에 전송한 고유하고 선택적인 앱 생성 식별자입니다(최대 255자).

string

application

이 결제와 관련된 앱입니다.

App

actions

이 결제에서 발생한 작업 유형 리스트입니다.

object[]

type

해당 작업의 유형입니다. type 은 다음 항목일 수 있습니다.

  • charge: 이 결제에서 발생한 작업의 유형이 'charge'(청구)라는 것을 나타냅니다. 청구의 상태가 완료이면 주문을 이행해야 합니다.
  • refund: 'refund'(환불) 유형은 결제가 환불되었음을 나타내며, 더 이상 이 거래에 대해 결제하지 않으므로 가능하면 소비자에게 판매한 아이템을 철회해야 합니다.
  • chargeback: 'chargeback'(결제 취소)은 소비자 측에서 비롯되며, 해당 은행에서 문제가 되는 결제에 이의를 제기합니다. 결제 취소가 발생하면 이 주문에 대해 결제하지 않으므로 가능하면 소비자에게서 게임 내 아이템을 철회해야 합니다.
  • chargeback_reversal: 'chargeback_reversal'(결제 취소 번복)은 결제 취소가 번복되었을 때 발생합니다. 이 경우, 이제 이 결제에 대해 지불받게 되므로 가능하면 소비자의 게임 내 아이템을 복원해야 합니다.
  • decline: 'decline'(거부)은 일괄 거래를 만드는 데 사용한 결제 수단이 결제 처리 시점에 거부되었을 때 발생합니다. 이 주문에 대해 결제하지 않으므로 가능하면 소비자에게서 게임 내 아이템을 철회해야 합니다. 일괄 거래와 거부에 관한 자세한 정보는 이의 제기 및 환불 처리를 참고하시기 바랍니다.

string

status

해당 작업의 상태입니다. status 은 다음 항목일 수 있습니다.

  • initiated: 결제가 'initiated'(시작됨) 유형은 결제가 시작되었을 뿐 아직 완전히 완료되지 않았음을 나타냅니다. 이 유형의 주문을 소비자에게 이행해서는 안 되며, 해당 상태의 결제에 대해 실시간 업데이트를 받지 않아야 합니다. 해당 거래가 완료되면 실시간 업데이트를 받게 됩니다. 개발자는 결제하는 데 시간이 오래 필요한 특정 결제 수단(예를 들어, 사용자가 온라인으로 양식을 작성하고, 영수증을 출력하고, 오프라인 은행에 가서 결제해야 하는 특정 방식)에서 'initiated' 상태가 표시될 수 있습니다.
  • completed: 'completed'(완료됨) 상태는 작업이 성공적으로 완료되었음을 나타냅니다. 작업 유형이 'charge'인 경우 소비자에게 주문을 이행해야 합니다. 마찬가지로 작업 유형이 'refund'인 경우 소비자에게서 아이템을 철회해야 합니다.
  • failed: 기본 유형에 대해 실패한 작업을 나타냅니다. 이 값은 'charge' 및 'refund' 작업 유형에서 모두 나타날 수 있습니다.

string

amount

이 작업에 적용되는 금액입니다.

string

currency

이 작업에서 amount 위 금액의 통화입니다.

string

time_created

이 작업이 발생한 시각입니다.

datetime

time_updated

이 작업이 마지막으로 업데이트된 시각입니다.

datetime

tax_amount

Facebook에서 납부한 모든 세금에 대해 정산 금액에서 차감된 금액입니다. 만일 tax 가 not_taxed 또는 already_paid 와 같을 경우 이 필드는 생략됩니다.

string

items

결제와 관련된 아이템입니다.

object[]

type

이 아이템의 유형입니다.

enum{IN_APP_PURCHASE, SUBSCRIPTION}

product

이 아이템의 제품 URL입니다.

string

quantity

이 아이템을 구매한 수량입니다.

integer

country

구매자의 ISO 국가 코드입니다(세금에 필요).

string

tax

세금 매개변수는 해당 금액이 과세 대상(VAT 또는 판매세)인지, 그렇다면 세금을 어떻게 지불하는지 지정합니다. 이는 다음과 같은 값을 가질 수 있습니다.

  • not_taxed: 이 결제에 VAT가 없는 이유는 유럽연합 이외 지역에서 발생했기 때문입니다.
  • already_paid: 이 결제에 대한 세금을 이미 사용자의 이동통신사나 다른 사업자가 지불한 경우입니다.

  • tax_remitted: Facebook에서 대신 이 결제에 대한 VAT를 지불한 경우입니다. 세액이 정산 금액에서 차감됩니다. 여기에서 자세한 내용을 확인하세요.

  • tax_remitted_USMPF: Facebook에서 대신 이 결제에 대한 판매세를 징수하고 지불한 경우입니다. 정산 금액에서 세액이 차감되지만 청구된 세액이 상품 가격에 더해지므로 총 정산 금액에는 영향을 미치지 않습니다. 여기에서 자세한 내용을 확인하세요.

string

tax_country

구매에 대해 Facebook이 세금 계산 대상으로 결정한 국가로, ISO 3166-1 alpha-2 국가 코드로 표시됩니다. 참고: 이 필드는 참조용이므로, 재계산이나 조정에 사용할 수 없습니다. 만일 tax 가 not_taxed 또는 already_paid 와 같을 경우 이 필드는 생략됩니다.

string

created_time

결제가 처음 만들어진 시각입니다.

string

payout_foreign_exchange_rate

USD로 송금된 정산 금액을 계산하는 데 사용한 환율입니다.

float

disputes

이의 제기와 관련된 정보( user_comment 및 user_email 등)가 포함되어 있으며, 그중 이메일 주소는 이의 제기가 시작되었을 때 소비자가 제공합니다. 또한 현재 이의 제기의 상태, 이의 제기가 만들어진 시각, 해결 사유 등이 포함됩니다(가능한 경우).

object[]

user_comment

이의 제기가 시작될 때 소비자가 제공한 의견입니다.

string

user_email

이의 제기가 시작될 때 소비자가 제공한 이메일 주소입니다.

string

time_created

이의 제기가 만들어진 시각입니다.

datetime

status

현재 이의 제기의 상태입니다.

enum{resolved, pending}

reason

이의 제기가 해결된 후 개발자 또는 Facebook 측에서 이의 제기에 대해 제시한 해결책의 사유입니다.

enum{pending, refunded_in_cash, granted_replacement_item, denied_refund, banned_user, refunded_by_facebook}

test

앱의 대시보드에 나열된 결제 테스터로 결제가 이루어질 때 나타나는 선택적 매개변수입니다. 소비자의 결제 수단에 청구되지 않은 거래를 나타냅니다.

boolean

게시

Facebook 결제를 이용하여 결제를 만들 수 있습니다.

삭제

이 API를 사용하여 결제를 삭제할 수 없습니다.

업데이트

이 에지를 이용하여 결제를 업데이트할 수 없습니다.

에지

이름 설명

/dispute

결제의 이의 제기 상태를 업데이트합니다.

/refunds

결제를 환불합니다.