# Source: https://docs.solidfi.com/v2/api-reference/cards/provision-a-card.md

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.solidfi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Provision a Card

> Provision a Card on Apple Pay, Google Pay and Samsung Pay



## OpenAPI

````yaml post /v2/issuing/card/{card_id}/provision
openapi: 3.0.3
info:
  title: Solid v2
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.sandbox.solidfi.com
  - url: https://api.prod.solidfi.com
security: []
tags:
  - name: Master Accounts
  - name: Sub Account Holders
  - name: Sub Accounts
  - name: Counterparties
  - name: Card Holders
  - name: Cards
  - name: Transactions
  - name: Attachments
  - name: Webhooks
  - name: Simulation
  - name: ACH
  - name: Card
paths:
  /v2/issuing/card/{card_id}/provision:
    parameters:
      - name: card_id
        in: path
        required: true
        schema:
          type: string
    post:
      tags:
        - Cards
      summary: Provision a Card
      description: Provision a Card on Apple Pay, Google Pay and Samsung Pay
      operationId: ProvisionACard
      parameters:
        - name: api-key
          in: header
          schema:
            type: string
            example: '{{api_key}}'
            description: >-
              API key is required to call Solid APIs. You can view and manage
              your API keys in the Solid dashboard.
          required: true
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                wallet:
                  type: string
                  example: apple_pay
                  description: wallet type
                  enum:
                    - apple_pay
                    - google_pay
                    - samsung_pay
                apple_pay:
                  type: object
                  properties:
                    device_cert:
                      type: string
                      example: >-
                        MIID/TCCA6OgAwIBAgIIMq/qUa9Z2nMwCgYIKoZIzj0EAwIwgYAxNDAyBgNVBAMMK0FwcGxlIFdvcmxkd2lkZSBEZXZlbG9wZXIgUmVsYXRpb25zIENBIC0gRzIxJjAkBgNVBAsMHUFwcGxlIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MRMwEQYDVQQKDApBcHBsZSBJbmMuMQswCQYDVQQGEwJVUzAeFw0xODA2MDEyMjAzMTBaFw0yMDA2MzAyMjAzMTBaMGwxNTAzBgNVBAMMLGVjYy1jcnlwdG8tc2VydmljZXMtZW5jaXBoZXJtZW50X1VDNi1TQU5EQk9YMREwDwYDVQQLDAhBcHBsZVBheTETMBEGA1UECgwKQXBwbGUgSW5jLjELMAkGA1UEBhMCVVMwWTATBgcqhkjOPQIBBggqhkjOPQMBBwNCAATGiJjmEMmvOZBGj+tdj2ED7xnc9y1C0vNVaqZva7lvKkbgrfcWdo0/NdIJZ5wDcZ0eBtPuRJ+q/eSP9FLXQ19wo4ICGDCCAhQwDAYDVR0TAQH/BAIwADAfBgNVHSMEGDAWgBSEtoTMOoZichZZlOgao71I3zrfCzBHBggrBgEFBQcBAQQ7MDkwNwYIKwYBBQUHMAGGK2h0dHA6Ly9vY3NwLmFwcGxlLmNvbS9vY3NwMDMtYXBwbGV3d2RyY2EyMDUwggEdBgNVHSAEggEUMIIBEDCCAQwGCSqGSIb3Y2QFATC=
                      description: >-
                        Apple device X.509 certificates received from mobile
                        application
                    nonce_signature:
                      type: string
                      example: >-
                        QHuLYArUCO2OZevP0rHc99g9RJp4O1dgsZuVpUdlA7zPWqCDhVQo9Mxr1uPS6GVyjZYo3YElIhHRV4
                      description: Signature signed by Apple on nonce in SE
                    nonce:
                      type: string
                      example: kbcVuA==
                      description: 32 digit random number generated by Apple
                google_pay:
                  type: object
                  properties:
                    client_customer_id:
                      type: string
                      example: 9uHEoxYfxFTBaP3GH3j
                      description: The user's Google wallet account ID
                    device_id:
                      type: string
                      example: oyyKWMhPraREjeQN6VI
                      description: >-
                        The user's Android device ID, the device's unique
                        identifier
                samsung_pay:
                  type: object
                  properties:
                    client_customer_id:
                      type: string
                      example: 9uHEoxYfxFTBaP3GH3j
                      description: The user's Google wallet account ID
                    device_id:
                      type: string
                      example: oyyKWMhPraREjeQN6VI
                      description: >-
                        The user's Android device ID, the device's unique
                        identifier
            examples:
              Provision a Card:
                value:
                  wallet: apple_pay
                  apple_pay:
                    device_cert: >-
                      MIID/TCCA6OgAwIBAgIIMq/qUa9Z2nMwCgYIKoZIzj0EAwIwgYAxNDAyBgNVBAMMK0FwcGxlIFdvcmxkd2lkZSBEZXZlbG9wZXIgUmVsYXRpb25zIENBIC0gRzIxJjAkBgNVBAsMHUFwcGxlIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MRMwE29uZGl0aW9ucyBvZiB1c2UsIGNlcnRpZmljYXRlIHBvbGljeSBhbmQgY2VydGlmaWNhdGlvbiBwcmFjdGljZSBzdGF0ZW1lbnRzLjA2BggrBgEFBQcCARYqaHR0cDovL3d3dy5hcHBsZS5jb20vY2VydGlmaWNhdGVhdXRob3JpdHkvMDYGA1UdHwQvMC0wK6ApoCeGJWh0dHA6Ly9jcmwuYXBwbGUuY29tL2FwcGxld3dkcmNhMi5jcmwwHQYDVR0OBBYEFMNruSHk5gH1LauD+wBI/9sgl/VpMA4GA1UdDwEB/wQEAwIDKDASBgkqhkiG92NkBicBAf8EAgUAMAoGCCqGSM49BAMCA0gAMEUCIQDhL+sL9bcrvAVO3UvswA805EHujfL7iVDrbEuJfOSJoAIgBPKehtuILl9x/SJ5kxReiml1zkJqUB8nTy0UOfUNIIQ=
                    nonce_signature: >-
                      QHuLYArUCO2OZevP0rHc99g9RYo3YElIhHRV4Mv3wEJ3hGOaxK1gResup88QWDK1fL0
                    nonce: kbcVuA==
      responses:
        '200':
          description: Provision a Card
          content:
            application/json:
              schema:
                type: object
                properties:
                  wallet:
                    type: string
                    example: apple_pay
                    description: wallet type
                    enum:
                      - apple_pay
                      - google_pay
                      - samsung_pay
                  apple_pay:
                    type: object
                    properties:
                      payment_account_reference:
                        type: string
                        example: V123456789012451423499
                        description: >-
                          Payment Account Reference (PAR) is a unique reference
                          value associated with a specific cardholder PAN
                      activation_data:
                        type: string
                        example: >-
                          TUJQQUMtMS1GSy00MDEyMDAuMS0tVERFQS1CMEQwQjcxNDNFN0M1QTc3M0I5MTc1OTA3RENCMUEzRUNCRENCQjJEMzI2MDBEOEY4RTU5OEI5QzE4OTlwMg==
                        description: >-
                          Activation data consisting of encrypted nonce,
                          noncesignature, and authCode in base64 format
                      encrypted_pass_data:
                        type: string
                        example: >-
                          V3bICnkm37BmBKEF9FAKK2zh2SvLhe6PqjvJaHS2t0eJaKVL/SfQ8mXOkDN7o4h7ayFmSuBy7A4R9uYWqWdZbo7fc0xOcsQLCgwQdVkW90JHAgL6j9axg26+OxrWyo7T9qm6NBlZzQFAy1oqYmw1tq6QMAEfbv7W6omlZMojl7aJjvzETINq/YXY8Xp76hoMQFsNDpnNfFuAONmCaCm5Vd6a1zW4ULI0SC1OPo8SdiEULTtZQO1XwiMtbD31JkSUhvHAEP2uo9bEeytPQwr82u6lxzzjLhBP30JByQeOJ2y2o/k83XNGanZhlR1yojp9gObw6m/wyj/rfGxMFVhZtzDVFDblgp1NzvCkPx0iyMRTURGLLmzyrLpzwVGIqv39GorEesOL1KtHb15KuwCtawdej3QiL95rPRTW58stEr/PxLh3Bp9AjlV07tJTXdrKNz357j8hLo1AmRv2p8prnZDF0A0j3jn71P68kvwvWhvZ3F+R0sNuC+E16IV1sJrWIlChU4NvcmsLBsv+ewsFqqGquDlpbFc3LuCQhE9PUu6wEGa7Im4e+Cbk79tcg+ZYFS1X4W7sAWLlxM0JzTMWdzSkqydLjiVc9FvoM3gBFrm/1rs7I5CACNg0vyHpXDhPFTM3a9enCqfWkZxNTfEfc3NOXte8s=
                        description: >-
                          Authentication data consisting of encrypted PAN,
                          expiry and datetime in base64 format
                      ephemeral_public_key:
                        type: string
                        example: BBSV6JzHhqoS0pLO6xMV6Z5yRhoOnpxaLv2+rp+/sK/RhLqLdEGok=
                        description: >-
                          VISA.ECC.ePK generated while creating MBPAD
                          encryptedInformation. EC point with P-256 curve and
                          uncompressed format. Base64 format
                  google_pay:
                    type: object
                    properties:
                      payment_account_reference:
                        type: string
                        example: V1234567890420053999
                        description: >-
                          Payment Account Reference (PAR) is a unique reference
                          value associated with a specific cardholder PAN
                      opaque_payment_card:
                        type: string
                        example: >-
                          eyJhdWQiOiIxODk5NzZhNi0yZmFjLTRlZDEtOTM0ZS03MjY5NmVhMDgxMzEiLCJraWQiOiJiYmVlZTAzOC1RMkFZM1Y1RTNJQ05CVVU2NkQ4SzExaEJtenFkWFN2VGlOelotWW5wb3pXUlhUbzUwIiwiaXNzIjoiYmJlZWUwMzgtNDgzMS00MjUzLWE3MjItMHY3NWNsMTNuNzFkIiwidHlwIjoiSk9TRSIsImNoYW5uZWxTZWN1cml0eUNvbnRleHQiOiJTSEFSRURfU0VDUkVUIiwiZW5jIjoiQTI1NkdDTSIsInRhZyI6ImEzOUM0RmxQbEhIMHBuczAtT2g1WGciLCJpYXQiOjE2NTQ4MzU3ODEsImFsZyI6IkEyNTZHQ01LVyIsIml2IjoibE9kcUc2Q2lwbW1SaV9VeSJ9.R9bp9RZ7qfxKNeB6QcmkpJs2-a7vmLLgJ7quOXRgCFQ.vuU9ubZevkKBaFWM.8XuSCadoQCJIGBgWmOS1jTZNIfbUHeRTUnVYpvE9PNEQFcoP04l-aSnd1NR0MDSfFlJA5Dh0QLBNxQOT_iR_M_9btzXes7fdKPNauiwexR8q42EIpx4a3G25WdHTzo2XUrbDBOqiFKM08qTW2wHhHzrffEfDVw4-gBECI4qrbwRPXbhOkAqeG3bU4gD9jAs0qv66mvJMP33Cqs_in0v8nAgOiPpufUkyXMzKpJjAXhptapEb9dxJyVYQ4JOoUrOEiPurUEwsf8NXscpydwiGDJVanKgOXw_v4NlRaVwFOrroF5bS0p1Y1mlfax6gf_hPKrTMcfTXcAwG21pwLEU0XH9WkuL-5b1GHMvQtcJM05WFWb0L2S1lyIqKg0zLuM8rDeLwtnvOTd3erwN64snGL9brjQ8BGM1fY54LBogrFFGDGuVPSCkG35OTAUKQ3aGPNn93bX9ujnnf0vRVHEQeFeahT1yXf2ZyCR6dNOnP1Ixj9degYj1xqYp_JwP64MlPWY4rJ2RGE0mMAVRvQVHKhKB9A_7nAvtGT2O6XQ
                        description: >-
                          This is the opaque card data that is needed by
                          GooglePay for tokenization
                  samsung_pay:
                    type: object
                    properties:
                      payment_account_reference:
                        type: string
                        example: V1234567890420053999
                        description: >-
                          Payment Account Reference (PAR) is a unique reference
                          value associated with a specific cardholder PAN
                      opaque_payment_card:
                        type: string
                        example: >-
                          This is the opaque card data that is needed by
                          SamsungPay for tokenization
                        description: opaque_payment_card
              examples:
                provision_a_card:
                  value:
                    wallet: apple_pay
                    apple_pay:
                      payment_account_reference: V123456720053999
                      activation_data: >-
                        TUJQQUMtMS1GSy00MDEyMDAuMS0tVERFQSDBEOEY4RTU5OEI5QzE4OTlGNzA3RjFCMDQ2RDY3RDNDREUwMg==
                      encrypted_pass_data: >-
                        V3bICnkm37BmBKEF9FAKK2zh2SvLhe6PqjvJaHS2t0eJaKVL/SfQ8mXOkDN7o4h7ayFmSuBy7A4R9uYWqWdZbo7fc0xOcsQLCgwQdVkW90JHAgL6j9axg26+OxrWyo7T9qm6NBlZzQFAy1oqYmw1tq6QMAEfbv7W6omlZ+ZYFS1X4W7sAWLlxM0JzTMWdzSkqydLjiVc9FvoM3gBFrm/1rs7I5CACNg0vyHpXDhPFTM3a9eysWef7qRdTxLIA7CUKDx59r4VTWtGijz1Pwb5uZCnYvZd3i/+T7ra4xZ+9Z6u/nCqfWkZxNTfEfc3NOXte8s=
                      ephemeral_public_key: >-
                        BBSV6JzHhqoS0pLO6xMV6Hxb7pPXpmNGra65K3kvUnlwfRTkWjA7v2+rp+/sK/RhLqLdEGok=
                    google_pay: null
                    samsung_pay: null
        '401':
          description: Unauthorized Error
          content:
            application/json:
              examples:
                show_card_example:
                  $ref: '#/components/examples/unauth_error'
        '404':
          description: Not Found Error
          content:
            application/json:
              examples:
                master_account_example:
                  $ref: '#/components/examples/card_not_found_error'
      security:
        - {}
components:
  examples:
    unauth_error:
      value:
        request_id: req_01900e34c96d7abfa970a9f454ab2d5d
        client_id: ''
        method: GET
        status: 401
        error:
          code: ERROR_CODE_UNAUTHORIZED
          message: unauthorized
          field_name: ''
        created_at: '2024-06-12T20:47:38Z'
    card_not_found_error:
      value:
        request_id: req_01900e959896706b870affad1b4d71dd
        client_id: ''
        method: GET
        status: 404
        error:
          code: ERROR_CODE_RESOURCE_NOT_FOUND
          message: cannot find card holder by id in qldb
          field_name: ''
        created_at: '2024-06-12T22:33:23Z'

````