| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Problem statement
Partners need a public API to bind an NP card to a business account or to a linked personal user.
Executive Summary
This endpoint exposes POST /v1/corporate-cards/bind.
It lets an authenticated partner bind a card to either:
- The business account.
- A linked personal user under that business account.
The request uses the card PAN and PIN, and the response returns the bound card details on success.
Integration model
| Mode | When to use | Required input | Result |
|---|---|---|---|
| Business bind | Bind the card to the business account | businessOrPersonal = Business, onBehalfOfUserId, fullPan, pin | The card is attached to the business account |
Request details
The request body accepts four fields:
| Field | Required | Description |
|---|---|---|
businessOrPersonal | Yes | Business |
onBehalfOfUserId | No, but required for personal binding | Personal user ID to bind the card for. |
fullPan | Yes | Full primary account number of the card. |
pin | Yes | Card PIN. |
If businessOrPersonal is Personal, the system validates that the personal user is linked to the business account. If that mapping does not exist, the request fails with 403 Forbidden.
The response returns the bound card object and standard API error fields.
Examples
Bind to the account
{
"businessOrPersonal": "Business",
"onBehalfOfUserId": "11111111-2222-3333-4444-555555555555",
"fullPan": "4111111111110040",
"pin": "1475"
}Security
[!WARNING]
fullPanandpinare sensitive cardholder data. Send this request only over HTTPS and handle the payload according to your PCI DSS controls.
Timeout: 2 seconds.