(Visual FoxPro) PayPal - Store Credit Card in Vault

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.

Chilkat ActiveX Downloads ActiveX for 32-bit and 64-bit Windows

LOCAL loJsonToken
LOCAL loSbAuth
LOCAL loRest
LOCAL lnBAutoReconnect
LOCAL lnSuccess
LOCAL loJson
LOCAL loSbJsonRequest
LOCAL loSbJsonResponse

* 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)
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.JsonObject')
loJsonToken = CreateObject('Chilkat.JsonObject')
loJsonToken.LoadFile("qa_data/tokens/paypal.json")

* Build the Authorization request header field value.
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.StringBuilder')
loSbAuth = CreateObject('Chilkat.StringBuilder')
* token_type should be "Bearer"
loSbAuth.Append(loJsonToken.StringOf("token_type"))
loSbAuth.Append(" ")
loSbAuth.Append(loJsonToken.StringOf("access_token"))

* 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.
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.Rest')
loRest = CreateObject('Chilkat.Rest')
lnBAutoReconnect = 1
lnSuccess = loRest.Connect("api.sandbox.paypal.com",443,1,lnBAutoReconnect)
IF (lnSuccess <> 1) THEN
    ? loRest.LastErrorText
    RELEASE loJsonToken
    RELEASE loSbAuth
    RELEASE loRest
    CANCEL
ENDIF

* ----------------------------------------------------------------------------------------------
* 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.
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.JsonObject')
loJson = CreateObject('Chilkat.JsonObject')
loJson.EmitCompact = 0
loJson.UpdateString("payer_id","user12345")
loJson.UpdateString("type","visa")
loJson.UpdateString("number","4032031087659974")
loJson.UpdateString("expire_month","9")
loJson.UpdateString("expire_year","2021")
loJson.UpdateString("first_name","Joe")
loJson.UpdateString("last_name","Shopper")

? loJson.Emit()

* 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"
* 	}

loRest.AddHeader("Authorization",loSbAuth.GetAsString())
loRest.AddHeader("Content-Type","application/json")

* Send the POST request containign the JSON in the request body, and get the JSON response.
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.StringBuilder')
loSbJsonRequest = CreateObject('Chilkat.StringBuilder')
loJson.EmitCompact = 1
loJson.EmitSb(loSbJsonRequest)
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.StringBuilder')
loSbJsonResponse = CreateObject('Chilkat.StringBuilder')
lnSuccess = loRest.FullRequestSb("POST","/v1/vault/credit-card",loSbJsonRequest,loSbJsonResponse)
IF (lnSuccess <> 1) THEN
    ? loRest.LastErrorText
    RELEASE loJsonToken
    RELEASE loSbAuth
    RELEASE loRest
    RELEASE loJson
    RELEASE loSbJsonRequest
    RELEASE loSbJsonResponse
    CANCEL
ENDIF

loJson.EmitCompact = 0
loJson.LoadSb(loSbJsonResponse)

? "Response Status Code = " + STR(loRest.ResponseStatusCode)

* Did we get a 201 success response?
IF (loRest.ResponseStatusCode <> 201) THEN
    ? loJson.Emit()
    ? "Failed."
    RELEASE loJsonToken
    RELEASE loSbAuth
    RELEASE loRest
    RELEASE loJson
    RELEASE loSbJsonRequest
    RELEASE loSbJsonResponse
    CANCEL
ENDIF

* a sample JSON response is shown below.
? loJson.Emit()

* // The "id" is what will be used to create a payment with the stored credit card.
? "card ID: " + loJson.StringOf("id")
? "success."

* ---------------------------------------------------------
* 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"
* 	    }
* 	  ]
* 	

RELEASE loJsonToken
RELEASE loSbAuth
RELEASE loRest
RELEASE loJson
RELEASE loSbJsonRequest
RELEASE loSbJsonResponse