--- title: "Issue Card" source_url: https://docs.rapyd.net/en/issue-card.html lang: en --- # Issue Card Issue a card to a wallet contact. > **Note:** > > - Clients with [PCI](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_pci "Payment Card Industry") certification can handle personal identifying information for cards. > - The contact must have an address and a country. ### Parameters ### Request Header Parameters - - access_key - Unique access key provided by Rapyd for each authorized user. See [Developers](https://docs.rapyd.net/en/developers.md "Developers"). - - Content-Type - Indicates that the data appears in JSON format. Set to **application/json**. - - idempotency - A unique key that prevents the platform from creating the same object twice. See [Idempotency](https://docs.rapyd.net/en/idempotency.md "Idempotency"). - - salt - Random string. Recommended length: 8-16 characters. - - signature - Signature calculated for each request individually. See [Request Signatures](https://docs.rapyd.net/en/request-signatures.md "Request Signatures"). - - timestamp - Timestamp for the request, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time") (seconds). ### Request Body Parameters - - card_program - ID of the card program that the card is issued from. String starting with **cardprog_**. - - country - The country where the card is issued. Two-letter ISO 3166-1 ALPHA-2 code. - - ewallet_contact - ID of the wallet contact that the card is assigned to. String starting with **cont_**. - - expiration_month - Expiration month of the card. Two digits. Relevant when the card issuer supports it for the country. - - expiration_year - Expiration year of the card. Two digits. Relevant when the card issuer supports it for the country. - - metadata - A JSON object defined by the client. See [Metadata](https://docs.rapyd.net/en/metadata.md "Metadata"). ### Response Parameters - - activated_at - Time that the card was activated, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time"). - - assigned_at - Time that the card was assigned to a cardholder, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time"). - - bin - [Bank Identifier Number](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_bin "Bank Identification Number") for the institution issuing the card. - - blocked_reason - Reason for blocking the card. One of the following: - **blocked_reversible** - **canceled** - **compliance** - **locked_incorrect_pin** - **migrated** - **none** - **other** - **reissued** - **suspected_fraud** none - - blocked_reason_code - Three letter code for the reason for blocking the card. One of the following values: - **CAN** - Canceled - **COM** - Compliance - **LOC** - Locked due to incorrect PIN - **LOS** - Lost - **MIG** - Migrated - **OTH** - Other - **REI** - Reissued - **SFR** - Suspected fraud - **STO** - Stolen - - card_id - ID of the card. String starting with **card_**. - - card_number - Actual card number. - - card_program - ID of the card program that the card is issued from. String starting with **cardprog_**. - - card_status_initiator - The initiator that asked for the card status update. One of the following three letter codes: - **CAH** - Cardholder - **COM** -Compliance operation - **DET** - Detect - **IGW** - Issuing gateway - **ISM** - Issuing merchant - **RSK** - Risk operation - **PRO** - Protect - - card_tracking_id - Reserved. - - country_iso_alpha_2 - The country where the card is issued. Two-letter ISO 3166-1 ALPHA-2 code. - - created_at - Time of creation of the issued card object, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time"). - - cvv - Card security code. - - expiration_month - Expiration month of the card. Two digits. Relevant when the card issuer supports it for the country. - - expiration_year - Expiration year of the card. Two digits. Relevant when the card issuer supports it for the country. - - ewallet_contact - Describes the wallet contact that the card is assigned to. String starting with **cont_**. For details about the fields in the 'contact' object, see [Add Contact to Wallet](https://docs.rapyd.net/en/add-contact-to-wallet.md "Add Contact to Wallet"). - - id - ID of the issued card object. String starting with **ci_**. - - metadata - A JSON object defined by the client. See [Metadata](https://docs.rapyd.net/en/metadata.md "Metadata"). - - public_details - Status of the card. One of the following: - `bin` - Bank ID number (BIN). - `last4` - Last 4 digits of the card. - `sub_bin` - Sub-BIN. - `expiration` - Expiration date as 4 digits. Relevant to [Issue Card](https://docs.rapyd.net/en/issue-card.md "Issue Card") and [List Issued Cards](https://docs.rapyd.net/en/list-issued-cards.md "List Issued Cards"). - - status - Status of the card. One of the following: - **ACT** - Active. - **BLO** - Blocked. - **IMP** - Imported in bulk, but not yet personalized. - **INA** - Inactive. - - sub_bin - Two-digit code. ### Code Samples - - .NET - ```csharp using System; using System.Text.Json; namespace RapydApiRequestSample { class Program { static void Main(string[] args) { try { var requestObj = new { ewallet_contact = "cont_3625cb4fc18d005b12f9ccf0c466755e", country = "US", }; string request = JsonSerializer.Serialize(requestObj); string result = RapydApiRequestSample.Utilities.MakeRequest("POST", "/v1/issuing/cards", request); Console.WriteLine(result); } catch (Exception e) { Console.WriteLine("Error completing request: " + e.Message); } } } } ``` - - JavaScript - ```javascript const makeRequest = require('../../../../Utilities/JS/utilities').makeRequest; async function main() { try { const body = { ewallet_contact: 'cont_3625cb4fc18d005b12f9ccf0c466755e', country: 'US' }; const result = await makeRequest('POST', '/v1/issuing/cards', body); console.log(result); } catch (error) { console.error('Error completing request', error); } } ``` - - PHP - ```php "cont_3625cb4fc18d005b12f9ccf0c466755e", "country" => "US" ]; try { $object = make_request('post', '/v1/issuing/cards', $body); var_dump($object); } catch(Exception $e) { echo "Error: $e"; } ?> ``` - - Python - ```python from pprint import pprint from utilities import make_request card = { "ewallet_contact": "cont_3625cb4fc18d005b12f9ccf0c466755e", "country": "US", } results = make_request(method='post', path=f'/v1/issuing/cards', body=card) pprint(results) ``` - /v1/issuing/cards - Issue Card - ```curl curl -X post 'https://sandboxapi.rapyd.net/v1/issuing/cards' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'idempotency: your-idempotency-parameter-here' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{ "ewallet_contact": "cont_cb60ec28c2f0bdfc621cfc21270c20ce", "card_program": "cardprog_b027c85a66ebebb2e094bca626d5ae97" }' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "af5b7379-2e12-45e8-a818-accffc4dca51" }, "data": { "id": "ci_d4fa9d7f43819d92c66125e2a7579fe6", "ewallet_contact": { "id": "cont_cb60ec28c2f0bdfc621cfc21270c20ce", "first_name": "John", "last_name": "Doe", "middle_name": "", "second_last_name": "", "gender": "not_applicable", "marital_status": "not_applicable", "house_type": "", "contact_type": "personal", "phone_number": "+14155551237", "email": "", "identification_type": "", "identification_number": "", "issued_card_data": { "preferred_name": "", "transaction_permissions": "", "role_in_company": "" }, "date_of_birth": "2000-12-15", "country": "NG", "nationality": null, "address": { "id": "address_8dc883799f2fcb5adb92bf77b6bc85b7", "name": "John Doe", "line_1": "123 Main Street", "line_2": "", "line_3": "", "city": "Anytown", "state": "", "country": "", "zip": "", "phone_number": "", "metadata": {}, "canton": "", "district": "", "created_at": 1755679320 }, "ewallet": "ewallet_3801e782955b29955445586a2405a5db", "created_at": 1612104554, "metadata": {}, "business_details": null, "compliance_profile": 0, "verification_status": "not verified", "send_notifications": false, "mothers_name": "" }, "status": "INA", "card_id": "card_0393b8437d759c5fb491d427b0000322", "assigned_at": 1760011681, "activated_at": 0, "metadata": {}, "country_iso_alpha_2": "BR", "created_at": 1760011681, "blocked_reason": "none", "card_tracking_id": null, "card_program": "cardprog_b027c85a66ebebb2e094bca626d5ae97", "public_details": { "bin": "534833", "last4": "7634", "sub_bin": "64", "expiration": "1028" }, "card_number": "5348330641217634", "cvv": "547", "expiration_month": "10", "expiration_year": "28", "bin": "534833", "sub_bin": "64" } } ```