add sep-12 documentation

documentation/sdk_examples/sep-0012-kyc.md

@@ -0,0 +1,112 @@
+
+### SEP-0012 - KYCService
+
+Helps clients to upload KYC (or other) information to anchors and other services in a standard way defined by [SEP-0012: KYC API](https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0012.md).
+
+
+
+
+### Create a KYCService instance 
+
+**By providing the domain hosting the stellar.toml file**
+
+```dart
+final kycService = await KYCService.fromDomain("kyc.domain.com");
+```
+
+This will automatically load and parse the stellar.toml file. It will then create the KYCService instance by using the kyc server url provided in the stellar.toml file. If no kyc server url is provided, than it will use the transfer server url to create the instance.
+
+**Or by providing the service url**
+
+Alternatively one can create a KYCService instance by providing the kyc service url directly via the constructor:
+
+```dart
+final kycService = KYCService("http://api.stellar-anchor.org/kyc");
+```
+
+
+
+### Get customer info
+
+This endpoint (described [here](https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0012.md#customer-get)) allows clients to:
+
+1. Fetch the fields the server requires in order to register a new customer via a PUT /customer request or
+2. Check the status of a customer that may already be registered
+
+With the flutter sdk you can use the ```getCustomerInfo``` of your ```KYCService``` instance to get the info:
+
+```dart
+GetCustomerInfoRequest request = new GetCustomerInfoRequest();
+request.jwt = jwtToken; // token received from stellar web auth - sep-0010
+request.id = customerId; // if customer already exists
+
+GetCustomerInfoResponse response = await kycService.getCustomerInfo(request);
+print(response.status);
+```
+
+
+
+### Upload customer info to an anchor
+
+This endpoint (described [here](https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0012.md#customer-put)) allows clients to upload customer information to an anchor in an authenticated and idempotent fashion. With the flutter sdk you can use the ```putCustomerInfo``` of your ```KYCService``` instance to upload the data:
+
+```dart
+NaturalPersonKYCFields kycFields = new NaturalPersonKYCFields();
+kycFields.firstName = "John";
+kycFields.lastName = "Doe";
+kycFields.mobileNumber = "(718) 454-7453";
+kycFields.photoIdBack = idBackImgData;
+// ...
+
+PutCustomerInfoRequest request = new PutCustomerInfoRequest();
+request.jwt = jwtToken; // token received from stellar web auth - sep-0010
+request.kycFields = kycFields;
+
+PutCustomerInfoResponse response = await kycService.putCustomerInfo(request);
+print(response.id);
+```
+
+
+
+### Customer verification
+
+This endpoint (described [here](https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0012.md#customer-put-verification)) allows servers to accept data values, usually confirmation codes, that verify a previously provided customer data field, such as mobile_number or email_address. With the flutter sdk you can use the ```putCustomerVerification``` of your ```KYCService``` instance to send the data values:
+
+```dart
+PutCustomerVerificationRequest request = new PutCustomerVerificationRequest();
+request.jwt = jwtToken; // token received from stellar web auth - sep-0010
+    
+Map<String, String> fields = {};
+fields["id"] = customerId;
+fields["mobile_number_verification"] = "2735021";
+request.verificationFields = fields;
+
+GetCustomerInfoResponse response = await kycService.putCustomerVerification(request);
+print(response.status);
+```
+
+
+
+### Delete customer
+
+This endpoint (described [here](https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0012.md#customer-delete)) allows clients to delete all personal information that the anchor has stored about a given customer. With the flutter sdk you can use the ```deleteCustomer``` of your ```KYCService``` instance to delete the data:
+
+```dart
+http.Response response = await kycService.deleteCustomer(accountId, null, null, jwtToken);
+print(response.status);
+```
+
+
+
+### Customer callback url
+
+This endpoint (described [here](https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0012.md#customer-callback-put)) allows the wallet to provide a callback URL to the anchor. Whenever the user's status field changes, the anchor will issue a POST request to the callback URL. With the flutter sdk you can use the ```putCustomerCallback``` of your ```KYCService``` instance to set the callback url:
+
+```dart
+PutCustomerCallbackRequest request = PutCustomerCallbackRequest();
+request.jwt = jwtToken; // token received from stellar web auth - sep-0010
+request.url = "https://qxd-wallet.com/ccup";
+
+http.Response response = await kycService.putCustomerCallback(request);
+print(response.status);
+```

test/sep0012_test.dart

@@ -374,6 +374,7 @@ void main() {
     Map<String, String> fields = {};
     fields["id"] = customerId;
     fields["mobile_number_verification"] = "2735021";
+    request.verificationFields = fields;
     request.jwt = jwtToken;
 
     GetCustomerInfoResponse infoResponse =
@@ -412,14 +413,6 @@ void main() {
       return http.Response(json.encode(mapJson), 400);
     });
 
-    PutCustomerVerificationRequest request =
-        new PutCustomerVerificationRequest();
-    request.id = customerId;
-    Map<String, String> fields = {};
-    fields["id"] = customerId;
-    fields["mobile_number_verification"] = "2735021";
-    request.jwt = jwtToken;
-
     http.Response response = await kycService.deleteCustomer(
         accountId, "memo test", "text", jwtToken);