Zig

PayPal - Store Credit Card in Vault

See more PayPal Examples

Saves the buyer's credit card information to PayPal's vault. This avoids storing credit card details on your server and thus PCI compliance is no longer an issue.

Note: For sandbox calls, you can use the credit card numbers provided in your sandbox test accounts.

Note: This example requires Chilkat v9.5.0.65 or greater.

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.65 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..
    // ----------------------------------------------------------------------------------------------

    // Build the JSON containing the credit card data.
    const json = try chilkat.JsonObject.init();
    defer json.deinit();
    json.setEmitCompact(false);
    json.updateString("payer_id", "user12345") catch {};
    json.updateString("type", "visa") catch {};
    json.updateString("number", "4032031087659974") catch {};
    json.updateString("expire_month", "9") catch {};
    json.updateString("expire_year", "2021") catch {};
    json.updateString("first_name", "Joe") catch {};
    json.updateString("last_name", "Shopper") catch {};

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

    // The JSON created by the above code is this:

    //     {
    //       "payer_id": "user12345",
    //       "type": "visa",
    //       "number": "4032031087659974",
    //       "expire_month": "9",
    //       "expire_year": "2021",
    //       "first_name": "Joe",
    //       "last_name": "Shopper"
    //     }

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

    // Send the POST request containign the JSON in the request body, and get the JSON response.
    const sb_json_request = try chilkat.StringBuilder.init();
    defer sb_json_request.deinit();
    json.setEmitCompact(true);
    json.emitSb(sb_json_request) catch {};
    const sb_json_response = try chilkat.StringBuilder.init();
    defer sb_json_response.deinit();
    rest.fullRequestSb("POST", "/v1/vault/credit-card", sb_json_request, sb_json_response) catch {
        std.debug.print("{s}\n", .{try rest.getLastErrorText(alloc)});
        return;
    };

    json.setEmitCompact(false);
    json.loadSb(sb_json_response) catch {};

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

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

    // a sample JSON response is shown below.
    std.debug.print("{s}\n", .{try json.emit(alloc)});

    // // The "id" is what will be used to create a payment with the stored credit card.
    std.debug.print("card ID: {s}\n", .{try json.stringOf(alloc, "id")});
    std.debug.print("success.\n", .{});

    // ---------------------------------------------------------
    // A sample JSON response:

    //     {
    //       "id": "CARD-52W84623JH8043102LA3CLGA",
    //       "state": "ok",
    //       "payer_id": "user12345",
    //       "type": "visa",
    //       "number": "xxxxxxxxxxxx9974",
    //       "expire_month": "9",
    //       "expire_year": "2021",
    //       "first_name": "Joe",
    //       "last_name": "Shopper",
    //       "valid_until": "2019-11-23T00:00:00Z",
    //       "create_time": "2016-11-23T23:26:16Z",
    //       "update_time": "2016-11-23T23:26:16Z",
    //       "links": [
    //         {
    //           "href": "https://api.sandbox.paypal.com/v1/vault/credit-card/CARD-52W84623JH8043102LA3CLGA",
    //           "rel": "self",
    //           "method": "GET"
    //         },
    //         {
    //           "href": "https://api.sandbox.paypal.com/v1/vault/credit-card/CARD-52W84623JH8043102LA3CLGA",
    //           "rel": "delete",
    //           "method": "DELETE"
    //         },
    //         {
    //           "href": "https://api.sandbox.paypal.com/v1/vault/credit-card/CARD-52W84623JH8043102LA3CLGA",
    //           "rel": "patch",
    //           "method": "PATCH"
    //         }
    //       ]
    //     }
}