إصدار ‏‎Graph API‎‏

/{payment-id}/refunds

يتم الاستخدام لإصدار أي عمليات لاسترداد أموال الدفع.

القراءة

يتعذر عليك قراءة عنصر الربط هذا.

النشر

يمكنك استخدام عنصر الربط هذا لبدء عمليات استرداد الأموال:

POST /v21.0/{payment-id}/refunds HTTP/1.1
Host: graph.facebook.com

currency=EUR&amount=1.00
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->post(
    '/{payment-id}/refunds',
    array (
      'currency' => 'EUR',
      'amount' => '1.00',
    ),
    '{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 */
Bundle params = new Bundle();
params.putString("currency", "EUR");
params.putString("amount", "1.00");
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{payment-id}/refunds",
    params,
    HttpMethod.POST,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
NSDictionary *params = @{
  @"currency": @"EUR",
  @"amount": @"1.00",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{payment-id}/refunds"
                                      parameters:params
                                      HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

الأذونات

  • يلزم توفير رمز وصول التطبيق لإصدار أي عمليات استرداد أموال لذلك التطبيق.

الحقول

الاسم الوصف النوع

currency

رمز العملة لمعيار ISO المكوّن من ثلاثة أحرف الذي يتم تحديد مبلغ استرداد الأموال من خلاله؛ يجب أن يكون مثل العملة التي تم إجراء عملية الدفع الأصلية بها. هذا مطلوب.

string

amount

المبلغ المطلوب استرداده. هذا مطلوب. يجب أن يكون أقل من الحقل refundable_amount أو يساويه في كائن الدفع الأساسي.

string

reason

سبب استرداد الأموال لهذا الطلب.

enum{MALICIOUS_FRAUD, FRIENDLY_FRAUD, CUSTOMER_SERVICE}

الاستجابة

إذا كانت ناجحة:

{
  "success": true
}

بخلاف ذلك، ستظهر رسالة الخطأ ذات الصلة.

الحذف

لا يمكنك الحذف باستخدام عنصر الربط هذا.