Marketing API Version

Transaction

Reading

A transaction is a record of payment for advertising services.

Examples

Graph API Explorer
GET v2.10/...?fields={fieldname_of_type_Transaction} HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
$request = new FacebookRequest(
  $session,
  'GET',
  '...?fields={fieldname_of_type_Transaction}'
);
$response = $request->execute();
$graphObject = $response->getGraphObject();
/* handle the result */
/* make the API call */
FB.api(
    "...?fields={fieldname_of_type_Transaction}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "...?fields={fieldname_of_type_Transaction}",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
// For more complex open graph stories, use `FBSDKShareAPI`
// with `FBSDKShareOpenGraphContent`
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"...?fields={fieldname_of_type_Transaction}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];
If you want to learn how to use the Graph API, read our Using Graph API guide.

Parameters

This endpoint doesn't have any parameters.

Fields

FieldDescription

id

string

ID of the transaction

account_id

string

ID of the source Ad Account

app_amount

TransactionCurrencyAmount

Monetary amount given to the app for this transaction

billing_end_time

unsigned int32

End time of the transaction's billing period

billing_reason

string

Explains why the ad account was charged.

billing_start_time

unsigned int32

Start time of the transaction's billing period

charge_type

string

Type of charge involved in the transaction

checkout_campaign_group_id

string

ID of the campaign group associated with this transaction

credential_id

string

ID of the credential used in this transaction charge

fatura_id

unsigned int32

ID for the Brazilian invoice (if transaction was made in Brazil) else 0

is_business_ec_charge

bool

Whether this transaction is business extended credit charge

payment_option

string

Method used to pay for the transaction

product_type

enum {facebook_ad, ig_ad}

The type of ads included in this transaction

provider_amount

TransactionCurrencyAmount

Monetary amount charged to the user for this transaction

status

string

Current status of the transaction

time

unsigned int32

Time at which the transaction was created

tracking_id

string

A 10-digit alphanumeric string which may be used to identify the payment.

Edges

No edges

Creating

You can't perform this operation on this endpoint.

Updating

You can't perform this operation on this endpoint.

Deleting

You can't perform this operation on this endpoint.