adds example of opaque data on CIM createCard

Author: alberto1el

README.md

@@ -26,7 +26,7 @@ The following gateways are provided by this package:
 * AuthorizeNet_SIM
 * AuthorizeNet_DPM
 
-In addition, `Accept.JS` is supported by the AIM driver. More details are provided below.
+In addition, `Accept.JS` is supported by the AIM driver and CIM (create card). More details are provided below.
 
 For general usage instructions, please see the main [Omnipay](https://github.com/thephpleague/omnipay)
 repository.
@@ -45,15 +45,15 @@ The card is tokenized into two values returned in `opaqueData` object from Accep
 
 These two values must be POSTed back to the merchant application, usually as a part of the payment form.
 Make sure the raw credit card details are NOT posted back to your site.
-How this is handled is beyond this short note, but examples are always welcome in the documentation.
+How this is handled is beyond this short note, but examples are always welcomed in the documentation.
 
-On the server, the tokenized detailt are passed into the `payment` or `authorize` request object.
+On the server, the tokenized details are passed into the `payment` or `authorize` request object.
 You will still need to pass in the `CreditCard` object, as that contains details of the payee and
 recipient, but just leave the credit card details of that object blank. For example:
 
 ```php
 // $gateway is an instantiation of the AIM driver.
-// $dataDescriptor and $dataValue come from the paymentr form at the front end.
+// $dataDescriptor and $dataValue come from the payment form at the front end.
 
 $request = $gateway->purchase(
     [
@@ -66,6 +66,56 @@ $request = $gateway->purchase(
 );
 ```
 
+CIM Create Card feature usage:
+Accept.js must be implemented on your frontend payment form, once Accept.js 'tokenizes' the customer's 
+card, just send the two opaque fields and remove the Card's (Number, Expiration and CVV) from your post request.
+
+Accept.js goal is to remove the need of Card information from ever going into your server so be sure to remove that data
+before posting to your server.
+
+The create card feature on CIM will automatically create a Customer Profile and a Payment Profile with the 
+'tokenized' card for each customer you request it for on your authorize.net account, you can use these Payment Profiles 
+later to request payments from your customers.
+
+In order to create a Customer & Payment Profile pass the opaque fields and the card array with the billing information
+to the createCard method on the CIM driver:
+
+```php
+// $gateway is an instantiation of the CIM driver. //Omnipay::create( 'AuthorizeNet_CIM' )
+// $dataDescriptor and $dataValue come from the payment form at the front end.
+
+$request = $gateway->createCard(
+    [
+        'opaqueDataDescriptor' => $dataDescriptor,
+        'opaqueDataValue' => $dataValue,
+        'name' => $name,
+        'email' => $email, //Authorize.net will use the email to identify the CustomerProfile 
+        'customerType' => 'individual',
+        'customerId' => $user_customer_id,//a customer ID generated by your system or send null
+        'description' => 'MEMBER',//whichever description you wish to send
+        'forceCardUpdate' => true
+        'card' => [
+            'billingFirstName' => $name,
+            'billingLastName' => $last_name,
+            'billingAddress1' => $address,
+            'billingCity' => $city,
+            'billingState' => $state,
+            'billingPostcode' => $zipcode,
+            'billingPhone' => '',
+            //... may include shipping info but do not include card (number, cvv or expiration)
+        ],
+    ]
+);
+$response = $request->send();
+$data = $response->getData();
+
+$data['paymentProfile']['customerProfileId'];
+$data['paymentProfile']['customerPaymentProfileId'];
+//Now you can use these 2 fields to reference this customer and this payment profile for later use with 
+//the rest of the CIM driver features as usual.
+```
+
+
 ## Support
 
 If you are having general issues with Omnipay, we suggest posting on