feat: add Collect Cards guide (#102)

* wip: create Collect Cards guide * wip: add storing cards section * wip: outline and conclusion * wip: add deduplication * wip: theme mermaid * wip: added masking * wip: aliasing * wip: add aliasing and fix progressive code * fix: apply verbiage review suggestions * fix: update ios api key * fix: react review * fix: PCI scope verbiage * fix: tabs + code styles and pr feedback
Basis-Theory · Apr 19, 2023 · 2488646 · 2488646 · vercel · Apr 19, 2023
1 parent dce7d24
commit 2488646
Show file tree

Hide file tree

Showing 21 changed files with 1,956 additions and 134 deletions.
diff --git a/docs/api/tokens/token-types.mdx b/docs/api/tokens/token-types.mdx
@@ -33,7 +33,7 @@ The `token` type is used for general data types that don't require input validat
 | ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | **Type**                           | `card`                                                                                                                                                                                                                       |
 | **Default Containers**             | `[ "/pci/high/" ]`                                                                                                                                                                                                           |
-| **Input Validation**               | See [Card Object](/docs/api/tokens#token-data-validations) for validation requirements                                                                                                                                       |
+| **Input Validation**               | See [Card Object](/docs/api/tokens#card-object) for validation requirements                                                                                                                                       |
 | **Default Fingerprint Expression** | `{{ data.number }}`                                                                                                                                                                                                          |
 | **Default Mask Expression**        | <code>{<br/>&nbsp;&nbsp;"number": "{{ data.number &#124; reveal_last: 4 }}",<br/>&nbsp;&nbsp;"expiration_month": "{{ data.expiration_month }}",<br/>&nbsp;&nbsp;"expiration_year": "{{ data.expiration_year }}"<br/>}</code> |
 
@@ -45,7 +45,7 @@ See [Test Card Numbers](/docs/api/testing#card-numbers) for suggested test data
 | ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | **Type**                           | `bank`                                                                                                                                                                  |
 | **Default Containers**             | `[ "/bank/high/" ]`                                                                                                                                                     |
-| **Input Validation**               | See [Bank Object](/docs/api/tokens#token-data-validations) for validation requirements                                                                                  |
+| **Input Validation**               | See [Bank Object](/docs/api/tokens#bank-object) for validation requirements                                                                                  |
 | **Default Fingerprint Expression** | <code>{{ data.account_number }}&#124;{{ data.routing_number }}</code>                                                                                                   |
 | **Default Mask Expression**        | <code>{<br/>&nbsp;&nbsp;"routing_number": "{{ data.routing_number }}",<br/>&nbsp;&nbsp;"account_number": "{{ data.account_number &#124; reveal_last: 4 }}"<br/>}</code> |
 

diff --git a/docs/blueprints/cards/collect-and-process-cards.mdx b/docs/blueprints/cards/collect-and-process-cards.mdx
@@ -44,7 +44,7 @@ yarn add @basis-theory/basis-theory-react
 
 ### Create a Public Application
 
-To securely collect cardholder data, you'll need a [Public Application](/docs/api/applications) using our PCI compliant template `Collect PCI Data`. [Click here to create one.](https://portal.basistheory.com/applications/create?application_template_id=db9148c1-a55f-4164-b830-a20ab6d720ae)
+To securely collect cardholder data, you'll need a [Public Application](/docs/api/applications) using our PCI-compliant template `Collect PCI Data`. [Click here to create one.](https://portal.basistheory.com/applications/create?application_template_id=db9148c1-a55f-4164-b830-a20ab6d720ae)
 
 This will create a PCI-compliant application with the following [Access Controls](/docs/concepts/access-controls):
 * Permissions: `token:create`, `token:update`

diff --git a/docs/concepts/what-are-tokens.mdx b/docs/concepts/what-are-tokens.mdx
@@ -230,7 +230,7 @@ In this example, we have a customer account we want to search over parts of the
 }
 ```
 
-In the above example, we can now perform a search with `john`, `doe`, `111-22-3333`, `3333`, `johndoe@[basistheory.com](http://basistheory.com)` or `basistheory.com` and get back the token. To see all additional capabilities of search, see our [API documentation](/docs/api/tokens/search).
+In the above example, we can now perform a search with `john`, `doe`, `111-22-3333`, `3333`, `johndoe@basistheory.com` or `basistheory.com` and get back the token. To see all additional capabilities of search, see our [API documentation](/docs/api/tokens/search).
 
 ### Deduplication
 

diff --git a/docs/expressions/fingerprints.mdx b/docs/expressions/fingerprints.mdx
@@ -7,7 +7,7 @@ import {Alert} from "../../src/components/shared/Alert";
 # Fingerprints
 
 A fingerprint can be generated at the time a token is created, which can be used to uniquely identify the contents of a token.
-Fingerprints are cryptographically secure and cannot be reversed to recover the original token's data,
+Fingerprints are cryptographically secure, protected against hash collision and preimage attacks, and cannot be reversed to recover the original token's data,
 so they are safe to store in your application and used to compare tokens without retrieving plaintext token data (e.g. for token [deduplication](/docs/concepts/what-are-tokens#deduplication)).
 
 Fingerprinting can either be globally enabled via the `Fingerprint All Tokens` [tenant setting](/docs/api/tenants#tenant-settings-object),
-Original file line number
+Diff line change
@@ Expand Up @@
     }
     ```
-    In the above example, we can now perform a search with `john`, `doe`, `111-22-3333`, `3333`, `johndoe@[basistheory.com](http://basistheory.com)` or `basistheory.com` and get back the token. To see all additional capabilities of search, see our [API documentation](/docs/api/tokens/search).
+    In the above example, we can now perform a search with `john`, `doe`, `111-22-3333`, `3333`, `johndoe@basistheory.com` or `basistheory.com` and get back the token. To see all additional capabilities of search, see our [API documentation](/docs/api/tokens/search).
     ### Deduplication
@@ Expand Down @@