curl --request POST \
--url https://api.bizconnectpay.com/api/v1/cards \
--header 'Authorization: Bearer <access_token>' \
--header 'Content-Type: application/json' \
--data '{
"customer_id": "f1bdad5d-bb31-410d-869c-44a28e876ded",
"wallet_id": "4e969910-8f06-4cd2-b92c-01765472e0e9",
"idempotency_key": "card-issuance-2026-001",
"debit_currency": "XAF",
"initial_balance": "10.00",
"category": "PERSONAL",
"grade": "STANDARD"
}'
{
"customer_id": "f1bdad5d-bb31-410d-869c-44a28e876ded",
"wallet_id": "4e969910-8f06-4cd2-b92c-01765472e0e9",
"idempotency_key": "card-issuance-2026-001",
"debit_currency": "XAF",
"initial_balance": "10.00",
"category": "PERSONAL",
"grade": "STANDARD"
}
{
"success": true,
"data": {
"card": {
"id": "3b2c08e5-d8f2-4886-aad1-88977d455ff8",
"virtual_card_customer_id": "f1bdad5d-bb31-410d-869c-44a28e876ded",
"provider_reference": "38537f3f-3948-43af-fd9d-08df17dfe646",
"issuance_reference": "card-issuance-2026-001",
"charged_amount": "2000.00000000",
"charged_currency": "XAF",
"environment": "LIVE",
"card_sequence": 1
},
"pricing": {
"card_currency": "USD",
"card_creation_fee_usd": "3.30",
"wallet_debit": {
"amount": "2000.00",
"currency": "XAF"
}
},
"reservation": {
"reference": "BCP-RSV-01JACD0R",
"status": "CAPTURED"
}
},
"meta": {
"correlation_id": "f9c35025-8a46-4238-982c-f4076c65ca47"
}
}
Cartes virtuelles
Émettre une carte virtuelle
Émettez une carte USD et débitez les frais dans la devise du portefeuille.
POST
/
cards
curl --request POST \
--url https://api.bizconnectpay.com/api/v1/cards \
--header 'Authorization: Bearer <access_token>' \
--header 'Content-Type: application/json' \
--data '{
"customer_id": "f1bdad5d-bb31-410d-869c-44a28e876ded",
"wallet_id": "4e969910-8f06-4cd2-b92c-01765472e0e9",
"idempotency_key": "card-issuance-2026-001",
"debit_currency": "XAF",
"initial_balance": "10.00",
"category": "PERSONAL",
"grade": "STANDARD"
}'
{
"customer_id": "f1bdad5d-bb31-410d-869c-44a28e876ded",
"wallet_id": "4e969910-8f06-4cd2-b92c-01765472e0e9",
"idempotency_key": "card-issuance-2026-001",
"debit_currency": "XAF",
"initial_balance": "10.00",
"category": "PERSONAL",
"grade": "STANDARD"
}
{
"success": true,
"data": {
"card": {
"id": "3b2c08e5-d8f2-4886-aad1-88977d455ff8",
"virtual_card_customer_id": "f1bdad5d-bb31-410d-869c-44a28e876ded",
"provider_reference": "38537f3f-3948-43af-fd9d-08df17dfe646",
"issuance_reference": "card-issuance-2026-001",
"charged_amount": "2000.00000000",
"charged_currency": "XAF",
"environment": "LIVE",
"card_sequence": 1
},
"pricing": {
"card_currency": "USD",
"card_creation_fee_usd": "3.30",
"wallet_debit": {
"amount": "2000.00",
"currency": "XAF"
}
},
"reservation": {
"reference": "BCP-RSV-01JACD0R",
"status": "CAPTURED"
}
},
"meta": {
"correlation_id": "f9c35025-8a46-4238-982c-f4076c65ca47"
}
}
idempotency_key identifie durablement l’émission. Réutilisez la même valeur lors d’une nouvelle tentative.
curl --request POST \
--url https://api.bizconnectpay.com/api/v1/cards \
--header 'Authorization: Bearer <access_token>' \
--header 'Content-Type: application/json' \
--data '{
"customer_id": "f1bdad5d-bb31-410d-869c-44a28e876ded",
"wallet_id": "4e969910-8f06-4cd2-b92c-01765472e0e9",
"idempotency_key": "card-issuance-2026-001",
"debit_currency": "XAF",
"initial_balance": "10.00",
"category": "PERSONAL",
"grade": "STANDARD"
}'
{
"customer_id": "f1bdad5d-bb31-410d-869c-44a28e876ded",
"wallet_id": "4e969910-8f06-4cd2-b92c-01765472e0e9",
"idempotency_key": "card-issuance-2026-001",
"debit_currency": "XAF",
"initial_balance": "10.00",
"category": "PERSONAL",
"grade": "STANDARD"
}
{
"success": true,
"data": {
"card": {
"id": "3b2c08e5-d8f2-4886-aad1-88977d455ff8",
"virtual_card_customer_id": "f1bdad5d-bb31-410d-869c-44a28e876ded",
"provider_reference": "38537f3f-3948-43af-fd9d-08df17dfe646",
"issuance_reference": "card-issuance-2026-001",
"charged_amount": "2000.00000000",
"charged_currency": "XAF",
"environment": "LIVE",
"card_sequence": 1
},
"pricing": {
"card_currency": "USD",
"card_creation_fee_usd": "3.30",
"wallet_debit": {
"amount": "2000.00",
"currency": "XAF"
}
},
"reservation": {
"reference": "BCP-RSV-01JACD0R",
"status": "CAPTURED"
}
},
"meta": {
"correlation_id": "f9c35025-8a46-4238-982c-f4076c65ca47"
}
}
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Maximum string length:
100Required string length:
3Required range:
x >= 0Available options:
PERSONAL, BUSINESS, null Available options:
STANDARD, PREMIUM, null 