Skip to main content

Documentation

Activate Issued Card Using API

Activate a card that was issued via the Rapyd issuing platform.

This method triggers the Issued Card Activated Webhook.

Note

Clients with PCI certification can handle personal identifying information for cards, such as card number.

Parameters
Request Header Parameters
Request Body Parameters

    • card

    • The card token, which is a string starting with 'card_'. If the client is PCI-certified, you can use the actual card number.

Response Parameters
Code Samples

    • .NET

      • using System;
using System.Text.Json;

namespace RapydApiRequestSample
{
    class Program
    {
        static void Main(string[] args)
        {
            try
            {
                var requestObj = new
                {
                    card = "card_0f1adc892adfd1885ab8a5236f8bf4b2",

                };

                string request = JsonSerializer.Serialize(requestObj);

                string result = RapydApiRequestSample.Utilities.MakeRequest("POST", "/v1/issuing/cards/activate", request);
                Console.WriteLine(result);
            }
            catch (Exception e)
            {
                Console.WriteLine("Error completing request: " + e.Message);
            }
        }
    }
}

    • JavaScript

      • const makeRequest = require('../../../../Utilities/JS/utilities').makeRequest;

async function main() {
  try {
    const body = {
      card: 'card_0f1adc892adfd1885ab8a5236f8bf4b2'
    };
    const result = await makeRequest('POST', '/v1/issuing/cards/activate', body);

    console.log(result);
  } catch (error) {
    console.error('Error completing request', error);
  }
}

    • PHP

      • <?php
$path = $_SERVER['DOCUMENT_ROOT'];
$path .= "/code_race_2020/Utilities/PHP/utilities.php";
include($path);
$body = [
    "card" => "card_0f1adc892adfd1885ab8a5236f8bf4b2"
];
try {
    $object = make_request('post', '/v1/issuing/cards/activate', $body);
    var_dump($object);
} catch(Exception $e) {
    echo "Error: $e";
}
?>

    • Python

      • from pprint import pprint

from utilities import make_request

card = {
    "card": "card_0f1adc892adfd1885ab8a5236f8bf4b2"
}

results = make_request(method='post', path=f'/v1/issuing/cards/activate', body=card)
pprint(results)

  • /v1/issuing/cards/activate

  • Activate Issued Card by Card ID

  • curl -X post
https://sandboxapi.rapyd.net/v1/issuing/cards/activate
-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'
-d '{
	"card": "card_0f1adc892adfd1885ab8a5236f8bf4b2"
}
'

  • {
    "status": {
        "error_code": "",
        "status": "SUCCESS",
        "message": "",
        "response_code": "",
        "operation_id": "041a3e3b-fb3f-445f-b80a-aaca1f33ff57"
    },
    "data": {
        "id": "ci_8f058c091dcc9eb2f7b3e4dedc7b773e",
        "ewallet_contact": {
            "id": "cont_3625cb4fc18d005b12f9ccf0c466755e",
            "first_name": "John",
            "last_name": "Doe",
            "middle_name": "",
            "second_last_name": "",
            "gender": "not_applicable",
            "marital_status": "not_applicable",
            "house_type": "",
            "contact_type": "business",
            "phone_number": "+14155551234",
            "email": "johndoefourstar@rapyd.net",
            "identification_type": "PA",
            "identification_number": "1234567890",
            "date_of_birth": "2000-11-22",
            "country": "US",
            "nationality": "NL",
            "address": {
                "id": "address_9706af91b503c70a819605222afabc96",
                "name": "John Doe - Four Star Professional Services",
                "line_1": "123 Main Street",
                "line_2": "",
                "line_3": "",
                "city": "Anytown",
                "state": "NY",
                "country": "US",
                "zip": "12345",
                "phone_number": "+14155551234",
                "metadata": {},
                "canton": "",
                "district": "",
                "created_at": 1608023967
            },
            "ewallet": "ewallet_053d64c44834e1d3057ecb68a34c6b6c",
            "created_at": 1608023967,
            "metadata": {},
            "business_details": {
                "id": "busi_9d2952408ec5dec780f5b88a8fc174aa",
                "name": "Four Star Professional Services",
                "registration_number": "R24032020000",
                "entity_type": "company",
                "industry_category": "company",
                "industry_sub_category": "home services",
                "address": {
                    "id": "address_977b39b4b725fadc9040e1ee1e5df795",
                    "name": "John Doe - Four Star Professional Services",
                    "line_1": "1234 Main Street",
                    "line_2": "Suite 1200",
                    "line_3": "",
                    "city": "Anytown",
                    "state": "NY",
                    "country": "US",
                    "zip": "10101",
                    "phone_number": "14155557779",
                    "metadata": {
                        "merchant_defined": true
                    },
                    "canton": "",
                    "district": "",
                    "created_at": 1608023967
                },
                "created_at": 1608023967,
                "annual_revenue": 0,
                "establishment_date": null,
                "legal_entity_type": null,
                "cnae_code": null
            },
            "compliance_profile": 0,
            "verification_status": "not verified",
            "send_notifications": false,
            "mothers_name": "Jane Smith"
        },
        "status": "ACT",
        "card_id": "card_0f1adc892adfd1885ab8a5236f8bf4b2",
        "assigned_at": 1615449397,
        "activated_at": 1615450671,
        "metadata": {},
        "country_iso_alpha_2": "US",
        "created_at": 1615449397,
        "blocked_reason": "none",
        "card_program": null
    }
}

  • Activate Issued Card by Card Number

  • curl -X post
https://sandboxapi.rapyd.net/v1/issuing/cards/activate
-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'
-d '{
	"card": "5320575303040441"
}
'

  • {
    "status": {
        "error_code": "",
        "status": "SUCCESS",
        "message": "",
        "response_code": "",
        "operation_id": "dddaf789-a846-4633-8fca-2c9e1c7602cf"
    },
    "data": {
        "id": "ci_e8ee515509f04c5c7a13c20dcc7a3c7b",
        "ewallet_contact": {
            "id": "cont_c34bd6bfd9575f6f7b06647999a93126",
            "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": "+14155551234",
            "email": "johndoe@rapyd.net",
            "identification_type": "PA",
            "identification_number": "1234567890",
            "date_of_birth": "2000-11-22",
            "country": "US",
            "nationality": "FR",
            "address": {
                "id": "address_0369eae8bddfc70521f9407212a7b675",
                "name": "John Doe",
                "line_1": "123 Main Street",
                "line_2": "",
                "line_3": "",
                "city": "Anytown",
                "state": "CA",
                "country": "US",
                "zip": "12345",
                "phone_number": "",
                "metadata": {},
                "canton": "",
                "district": "",
                "created_at": 1606059282
            },
            "ewallet": "ewallet_755b0fd11fd22b33328fff7d30f3ce30",
            "created_at": 1606059282,
            "metadata": {},
            "business_details": null,
            "compliance_profile": 0,
            "verification_status": "not verified",
            "send_notifications": false,
            "mothers_name": ""
        },
        "status": "ACT",
        "card_id": "card_34d9a74d81ba015f96a8066938d5fd37",
        "assigned_at": 1615449817,
        "activated_at": 1615451181,
        "metadata": {},
        "country_iso_alpha_2": "BR",
        "created_at": 1615449817,
        "blocked_reason": "none",
        "card_program": "cardprog_b027c85a66ebebb2e094bca626d5ae97"
    }
}
In this section:

All financial institutions that issue cards or process card transactions. The Payment Card Industry Security Standards Council develops and publishes regulations for the industry.

The number of seconds elapsed since the beginning of the Unix epoch, which was 00:00:00 GMT on January 1, 1970. 10-digit integer.

Most stringent compliance level under the Payment Card Industry Data Security Standard (PCI-DSS). Clients with Level 1 clearance can handle personal identifying information for cards, such as card number, expiration date and cardholder name.