Store Card in Vault

POST

/dpm/cofre-gw-proxy/v1/cards

Store Card in Vault

This endpoint securely stores a consumer’s card information in Getnet’s digital vault for future use. It allows the creation of a reusable card resource based on previously tokenized data, enabling seamless and secure transactions without requiring the card details again.

Usage Scenarios:
- Tokenizing and saving card data for future payments.
- Enabling subscriptions or billing cycles without re-entering card information.
- Minimizing PCI scope by leveraging secure storage of sensitive data.

Notes:
- This operation requires a previously generated tokenized card number (number_token), typically obtained via the /v1/tokens/card endpoint.
-The card data is stored securely, and sensitive fields like CVV are never stored.
- You may optionally skip card verification by using the x-by-pass-parameters header.

请求参数

Authorization

OAuth 2.0

Client Credentials

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Token URL: https://api.globalgetnet.com/authentication/oauth2/access_token

OAuth 2.0

Client Credentials

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Token URL: https://api.pre.globalgetnet.com/authentication/oauth2/access_token

OAuth 2.0

Client Credentials

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Token URL: https://api-sbx.globalgetnet.com/authentication/oauth2/access_token

Scopes:

digital-platform:gateway-api-Read and write access

Header 参数

Body 参数application/json必填

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/dpm/cofre-gw-proxy/v1/cards' \
--header 'x-by-pass-parameters;' \
--header 'Content-Type: application/json' \
--data '{
    "number_token": "dfe05208b105578c070f806c80abd3af09e246827d29b866cf4ce16c205849977c9496cbf0d0234f42339937f327747075f68763537b90b31389e01231d4d13c",
    "brand": "Mastercard",
    "cardholder_name": "JOAO DA SILVA",
    "expiration_month": "12",
    "expiration_year": "28",
    "customer_id": "customer_21081826",
    "cardholder_identification": "12345678912",
    "verify_card": true,
    "security_code": "123",
    "transaction_id": "3123131241412"
}'

返回响应

🟢201

application/json; charset=utf-8

Card identifier created successfully. Card saved in safe.

Bodyapplication/json; charset=utf-8

示例

{
    "card_id": "e8ad2ae4-9e3e-4532-998f-1a5a11e56e58",
    "number_token": "dfe05208b105578c070f806c80abd3af09e246827d29b866cf4ce16c205849977c9496cbf0d0234f42339937f327747075f68763537b90b31389e01231d4d13c"
}

🟠400

🟠401

🟠403

🟠404

🔴500

修改于 2026-04-01 08:05:47

Get Cards By Customer Id

Get Card by Id