Skip to main content
POST
/
businesses
/
{id}
/
cards
Add business payout card
curl --request POST \
  --url https://api.guile.app/businesses/{id}/cards \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "securityCode": "<string>",
  "personalAccountNumber": "<string>",
  "expirationMonth": "<string>",
  "expirationYear": "<string>"
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "maskedPersonalAccountNumber": "<string>",
  "network": "visa",
  "fundingType": "debit",
  "expirationMonth": "<string>",
  "expirationYear": "<string>",
  "isDefault": true,
  "eligiblePayoutMethods": [
    "standard"
  ],
  "tokenizationMethod": "androidPay"
}

Path Parameters

​
id
string<uuid>
required

The unique, opaque system identifier for a resource. This case-sensitive ID is also used as path parameters in URLs or in other properties or parameters that reference a resource by ID rather than URL.

Body

application/json
​
securityCode
string
required

The card's security code.

Required string length: 3 - 4
Pattern: ^\d{3,4}$
​
personalAccountNumber
string
required

The unmasked personal account number for the card. Spaces are ignored in requests and omitted in responses.

Required string length: 14 - 19
Pattern: \d{1}[0-9 ]{12,17}\d{1}$
​
expirationMonth
string
required

The month portion of the card's MM/YYYY expiration in MM format.

Required string length: 2
Pattern: ^(0[1-9]|1[012])$
​
expirationYear
string
required

The year portion of the year of the card's MM/YYYY expiration, in YYYY format.

Required string length: 4
Pattern: ^\d{4}$

Response

Ok. The operation succeeded.

Representation of cards for business accounts on Guile.

​
id
string<uuid>
required

The unique identifier for the business card.

​
maskedPersonalAccountNumber
string
required

A masked card personal account number: an asterisk * followed by the last four digits of the full Personal Account Number (PAN).

Required string length: 5
Pattern: ^\*\d{4}$
​
network
enum<string>
required

The card payment processing network.

Available options:
visa,
discover,
mastercard,
amex,
other
​
fundingType
enum<string>
required

Indicates how a card is funded.

Available options:
debit,
credit,
prepaid,
other
​
expirationMonth
string
required

The month portion of the card's MM/YYYY expiration in MM format.

Required string length: 2
Pattern: ^(0[1-9]|1[012])$
​
expirationYear
string
required

The year portion of the year of the card's MM/YYYY expiration, in YYYY format.

Required string length: 4
Pattern: ^\d{4}$
​
isDefault
boolean
required

Indicates whether this card is the default payout card.

​
eligiblePayoutMethods
enum<string>[]
required

Supported payout methods for this financial account.

The method used for the payout. Standard typically means T+2 days through ACH batch processing. Instant expediates payments for an additional processing fee. Instant payouts be be limited based on availability and other factors.

Available options:
standard,
instant
​
tokenizationMethod
enum<string>

For digital cards with dynamic tokenization, this is the tokenization method.

Available options:
androidPay,
applePay,
masterPass,
visaCheckout