Sample code for 30+ languages & platforms
Zig

PayPal Search for Invoices

See more PayPal Examples

Search PayPal invoices.

See also SearchInvoices

Chilkat Zig Downloads

Zig
const std = @import("std");
const chilkat = @import("chilkat");

pub fn main(init: std.process.Init) !void {
    const alloc = init.arena.allocator();

    // Note: Requires Chilkat v9.5.0.64 or greater.

    // This requires the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    // Load our previously obtained access token. (see PayPal OAuth2 Access Token)
    const json_token = try chilkat.JsonObject.init();
    defer json_token.deinit();
    json_token.loadFile("qa_data/tokens/paypal.json") catch {};

    // Build the Authorization request header field value.
    const sb_auth = try chilkat.StringBuilder.init();
    defer sb_auth.deinit();
    // token_type should be "Bearer"
    sb_auth.append(try json_token.stringOf(alloc, "token_type")) catch {};
    sb_auth.append(" ") catch {};
    sb_auth.append(try json_token.stringOf(alloc, "access_token")) catch {};

    // Make the initial connection.
    // A single REST object, once connected, can be used for many PayPal REST API calls.
    // The auto-reconnect indicates that if the already-established HTTPS connection is closed,
    // then it will be automatically re-established as needed.
    const rest = try chilkat.Rest.init();
    defer rest.deinit();
    const b_auto_reconnect = true;
    rest.connect("api.sandbox.paypal.com", 443, true, b_auto_reconnect) catch {
        std.debug.print("{s}\n", .{try rest.getLastErrorText(alloc)});
        return;
    };

    // ----------------------------------------------------------------------------------------------
    // The code above this comment could be placed inside a function/subroutine within the application
    // because the connection does not need to be made for every request.  Once the connection is made
    // the app may send many requests..
    // ----------------------------------------------------------------------------------------------

    // Create JSON to specify the search
    const json = try chilkat.JsonObject.init();
    defer json.deinit();
    json.setEmitCompact(false);
    json.appendString("start_invoice_date", "2016-01-01 PST") catch {};
    json.appendString("end_invoice_date", "2016-11-16 PST") catch {};
    json.appendInt("page", 0) catch {};
    json.appendInt("page_size", 10) catch {};
    json.appendBool("total_count_required", true) catch {};

    std.debug.print("{s}\n", .{try json.emit(alloc)});

    // The JSON by the above code:

    //     {
    //       "start_invoice_date": "2016-01-01 PST",
    //       "end_invoice_date": "2016-11-16 PST",
    //       "page": 0,
    //       "page_size": 10,
    //       "total_count_required": true
    //     }

    // Send the POST equivalent to this CURL command:

    //     curl -v -X POST https://api.sandbox.paypal.com/v1/invoicing/search/ \
    //     -H "Content-Type:application/json" \
    //     -H "Authorization: Bearer Access-Token" \
    //     -d '{ invoice JSON goes here }'

    json.setEmitCompact(true);
    const sb_request_body = try chilkat.StringBuilder.init();
    defer sb_request_body.deinit();
    const sb_response_body = try chilkat.StringBuilder.init();
    defer sb_response_body.deinit();

    rest.addHeader("Content-Type", "application/json") catch {};
    rest.addHeader("Authorization", try sb_auth.getAsString(alloc)) catch {};
    json.emitSb(sb_request_body) catch {};

    rest.fullRequestSb("POST", "/v1/invoicing/search", sb_request_body, sb_response_body) catch {
        std.debug.print("{s}\n", .{try rest.getLastErrorText(alloc)});
        return;
    };

    // We should have some sort of JSON response.  It could be successful, or an error.
    const json_response = try chilkat.JsonObject.init();
    defer json_response.deinit();
    json_response.setEmitCompact(false);
    json_response.loadSb(sb_response_body) catch {};

    std.debug.print("Response Status Code = {d}\n", .{rest.getResponseStatusCode()});

    // Did we get a 200 success response?
    if (rest.getResponseStatusCode() != 200) {
        // Show the JSON response body
        std.debug.print("{s}\n", .{try json_response.emit(alloc)});
        std.debug.print("Failed.\n", .{});
        return;
    }

    // Sample response JSON is shown below.

    // Iterate over each invoice and get some information from each..
    const num_invoices = json_response.sizeOfArray("invoices");
    var i: i32 = 0;
    while (i < num_invoices) {
        json_response.setI(i);
        std.debug.print("Invoice ID: {s}\n", .{try json_response.stringOf(alloc, "invoices[i].id")});
        std.debug.print("Shipping First Name: {s}\n", .{try json_response.stringOf(alloc, "invoices[i].shipping_info.first_name")});
        var j: i32 = 0;
        const num_billing_info = json_response.sizeOfArray("invoices[i].billing_info");
        while (j < num_billing_info) {
            json_response.setJ(j);
            std.debug.print("billing_info email: {s}\n", .{try json_response.stringOf(alloc, "invoices[i].billing_info[j].email")});
            j = j + 1;
        }

        const num_links = json_response.sizeOfArray("invoices[i].links");
        j = 0;
        while (j < num_links) {
            json_response.setJ(j);
            std.debug.print("link: {s}\n", .{try json_response.stringOf(alloc, "invoices[i].links[j].href")});
            j = j + 1;
        }

        std.debug.print("----\n", .{});
        i = i + 1;
    }

    std.debug.print("Success.\n", .{});

    // A successful response looks like this:

    // {
    //   "total_count": 2,
    //   "invoices": [
    //     {
    //       "id": "INV2-XV4B-736P-PLVN-SZCE",
    //       "number": "0002",
    //       "status": "DRAFT",
    //       "merchant_info": {
    //         "email": "smith-facilitator@chilkatsoft.com"
    //       },
    //       "billing_info": [
    //         {
    //           "email": "smith-buyer@chilkatsoft.com"
    //         }
    //       ],
    //       "shipping_info": {
    //         "email": "smith-buyer@chilkatsoft.com",
    //         "first_name": "Sally",
    //         "last_name": "Patient",
    //         "business_name": "Not applicable"
    //       },
    //       "invoice_date": "2016-11-15 PST",
    //       "payment_term": {
    //         "due_date": "2016-12-30 PST"
    //       },
    //       "note": "Medical Invoice 16 Jul, 2013 PST",
    //       "total_amount": {
    //         "currency": "USD",
    //         "value": "500.00"
    //       },
    //       "metadata": {
    //         "created_date": "2016-11-15 08:09:21 PST"
    //       },
    //       "paid_amount": {
    //         "paypal": {
    //           "currency": "USD",
    //           "value": "0.00"
    //         },
    //         "other": {
    //           "currency": "USD",
    //           "value": "0.00"
    //         }
    //       },
    //       "refunded_amount": {
    //         "paypal": {
    //           "currency": "USD",
    //           "value": "0.00"
    //         },
    //         "other": {
    //           "currency": "USD",
    //           "value": "0.00"
    //         }
    //       },
    //       "links": [
    //         {
    //           "rel": "self",
    //           "href": "https://api.sandbox.paypal.com/v1/invoicing/invoices/INV2-XV4B-736P-PLVN-SZCE",
    //           "method": "GET"
    //         },
    //         {
    //           "rel": "send",
    //           "href": "https://api.sandbox.paypal.com/v1/invoicing/invoices/INV2-XV4B-736P-PLVN-SZCE/send",
    //           "method": "POST"
    //         },
    //         {
    //           "rel": "update",
    //           "href": "https://api.sandbox.paypal.com/v1/invoicing/invoices/INV2-XV4B-736P-PLVN-SZCE/update",
    //           "method": "PUT"
    //         },
    //         {
    //           "rel": "delete",
    //           "href": "https://api.sandbox.paypal.com/v1/invoicing/invoices/INV2-XV4B-736P-PLVN-SZCE",
    //           "method": "DELETE"
    //         }
    //       ]
    //     },
    //     {
    //       "id": "INV2-ZG2H-HKAW-PMWU-N6ZR",
    //       "number": "0001",
    //       "status": "SENT",
    //       "merchant_info": {
    //         "email": "smith-facilitator@chilkatsoft.com"
    //       },
    //       "billing_info": [
    //         {
    //           "email": "smith-buyer@chilkatsoft.com"
    //         }
    //       ],
    //       "shipping_info": {
    //         "email": "smith-buyer@chilkatsoft.com",
    //         "first_name": "Sally",
    //         "last_name": "Patient",
    //         "business_name": "Not applicable"
    //       },
    //       "invoice_date": "2016-11-15 PST",
    //       "payment_term": {
    //         "due_date": "2016-12-30 PST"
    //       },
    //       "note": "Medical Invoice 16 Jul, 2013 PST",
    //       "total_amount": {
    //         "currency": "USD",
    //         "value": "500.00"
    //       },
    //       "metadata": {
    //         "created_date": "2016-11-15 06:17:03 PST",
    //         "payer_view_url": "https://www.sandbox.paypal.com/cgi_bin/webscr?cmd=_pay-inv&viewtype=altview&id=INV2-ZG2H-HKAW-PMWU-N6ZR"
    //       },
    //       "paid_amount": {
    //         "paypal": {
    //           "currency": "USD",
    //           "value": "0.00"
    //         },
    //         "other": {
    //           "currency": "USD",
    //           "value": "0.00"
    //         }
    //       },
    //       "refunded_amount": {
    //         "paypal": {
    //           "currency": "USD",
    //           "value": "0.00"
    //         },
    //         "other": {
    //           "currency": "USD",
    //           "value": "0.00"
    //         }
    //       },
    //       "links": [
    //         {
    //           "rel": "self",
    //           "href": "https://api.sandbox.paypal.com/v1/invoicing/invoices/INV2-ZG2H-HKAW-PMWU-N6ZR",
    //           "method": "GET"
    //         },
    //         {
    //           "rel": "update",
    //           "href": "https://api.sandbox.paypal.com/v1/invoicing/invoices/INV2-ZG2H-HKAW-PMWU-N6ZR/update",
    //           "method": "PUT"
    //         },
    //         {
    //           "rel": "cancel",
    //           "href": "https://api.sandbox.paypal.com/v1/invoicing/invoices/INV2-ZG2H-HKAW-PMWU-N6ZR/remind",
    //           "method": "POST"
    //         },
    //         {
    //           "rel": "remind",
    //           "href": "https://api.sandbox.paypal.com/v1/invoicing/invoices/INV2-ZG2H-HKAW-PMWU-N6ZR/cancel",
    //           "method": "POST"
    //         },
    //         {
    //           "rel": "record-payment",
    //           "href": "https://api.sandbox.paypal.com/v1/invoicing/invoices/INV2-ZG2H-HKAW-PMWU-N6ZR/record-payment",
    //           "method": "POST"
    //         },
    //         {
    //           "rel": "qr-code",
    //           "href": "https://api.sandbox.paypal.com/v1/invoicing/invoices/INV2-ZG2H-HKAW-PMWU-N6ZR/qr-code",
    //           "method": "GET"
    //         }
    //       ]
    //     }
    //   ]
    // }
    //
}