Cards
Create A Card
Auth API
- How to authenticate
Deliver API
- Persons
- Businesses
- External Accounts
- Cards
- Transfers
- Schedules
- Eligibility
- Transfer Groups
- Balance
- Reports
Verify API
Webhooks API
- Overview And Set Up
- Event Types and Payloads
- Configure webhooks
- Trigger webhooks
- Secure webhooks
Cards
Create A Card
Create a card object.
POST
/
deliver
/
cards
curl --request POST \
--url https://vault.api-sandbox.orum.io/deliver/cards \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"account_reference_id": "<string>",
"customer_reference_id": "<string>",
"customer_resource_type": "business",
"account_holder_name": {
"first_name": "<string>",
"middle_name": "<string>",
"last_name": "<string>",
"suffix": "<string>"
},
"address": {
"zip5": "<string>"
},
"metadata": {},
"number": "<string>",
"expiration_month": 6,
"expiration_year": 2025
}'
{
"card": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"account_reference_id": "<string>",
"customer_reference_id": "<string>",
"customer_resource_type": "business",
"account_holder_name": {
"first_name": "<string>",
"middle_name": "<string>",
"last_name": "<string>",
"suffix": "<string>"
},
"status": "created",
"pull_eligible": true,
"push_eligible": true,
"address": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "billing",
"address1": "<string>",
"address2": "<string>",
"city": "<string>",
"state": "<string>",
"country": "US",
"zip5": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"closed_at": "2023-11-07T05:31:56Z",
"metadata": {},
"last4": "<string>",
"expiration_month": 6,
"expiration_year": 2025,
"status_reasons": [
{
"reason_code": "invalid_address",
"reason_code_message": "Address submitted is a non-supported address type"
}
]
}
}
-
To create a card, use POST
vault.api-sandbox.orum.io/deliver/cards
-
All other card endpoints will continue to use
api-sandbox.orum.io
-
This allows us to securely handle your card information
Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Body
application/json
Response
200
application/json
200 response.
The response is of type object
.
Was this page helpful?
curl --request POST \
--url https://vault.api-sandbox.orum.io/deliver/cards \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"account_reference_id": "<string>",
"customer_reference_id": "<string>",
"customer_resource_type": "business",
"account_holder_name": {
"first_name": "<string>",
"middle_name": "<string>",
"last_name": "<string>",
"suffix": "<string>"
},
"address": {
"zip5": "<string>"
},
"metadata": {},
"number": "<string>",
"expiration_month": 6,
"expiration_year": 2025
}'
{
"card": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"account_reference_id": "<string>",
"customer_reference_id": "<string>",
"customer_resource_type": "business",
"account_holder_name": {
"first_name": "<string>",
"middle_name": "<string>",
"last_name": "<string>",
"suffix": "<string>"
},
"status": "created",
"pull_eligible": true,
"push_eligible": true,
"address": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "billing",
"address1": "<string>",
"address2": "<string>",
"city": "<string>",
"state": "<string>",
"country": "US",
"zip5": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"closed_at": "2023-11-07T05:31:56Z",
"metadata": {},
"last4": "<string>",
"expiration_month": 6,
"expiration_year": 2025,
"status_reasons": [
{
"reason_code": "invalid_address",
"reason_code_message": "Address submitted is a non-supported address type"
}
]
}
}