Create issuing cards
POST {{baseInfraUrl}}/{{version}}/issuing-card
Create Issuing Cards with specific spending rules.
Parameters | Value Type | Description |
---|---|---|
holderName | REQUIRED | Cardholder's name. Example: name=Tony Stark |
holderTaxId | REQUIRED | Cardholder's CPF (11 digits formatted or unformatted) or CNPJ (14 digits formatted or unformatted). Example: holderTaxId=012.345.678-90 |
holderExternalId | REQUIRED | Cardholder's unique id, generated by the user to avoid duplicated holders. Example: my-entity/123 |
displayName | OPTIONAL | Card display name. Example: displayName=ANTHONY STARK. |
rules | OPTIONAL | Spending rules for the Issuing Card. List of dictionaries or a list of Issuing Rule objects containing: amount, currencyCode, id, interval and name. |
binId | OPTIONAL | Bin id to which the card is bound. Example: binId=538102. |
tags | OPTIONAL | List of strings for tagging. All tags will be converted to lowercase. Example: tags=[travel, food]. |
streetLine1 | OPTIONAL | Cardholder's main address. Example: streetLine1=Av. Paulista, 200. |
streetLine2 | OPTIONAL | Cardholder's address complement. Example: streetLine2=Apto. 123. |
district | OPTIONAL | Cardholder's address district / neighbourhood. Example: district=Bela Vista. |
city | OPTIONAL | Cardholder's address city. Example: district=Sao Paulo. |
stateCode | OPTIONAL | Cardholder's address state code. Example: stateCode=SP. |
zipCode | OPTIONAL | Cardholder's address zip code. Example: zipCode=01311-200. |
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
expand | string | Fields to expand information. |
Request Body
{"cards"=>[{"city"=>"Sao Paulo", "displayName"=>"ANTHONY STARK", "district"=>"Bela Vista", "holderExternalId"=>"my-entity/123", "holderName"=>"Tony Stark", "holderTaxId"=>"012.345.678-90", "rules"=>[{"amount"=>900000, "currencyCode"=>"BRL", "interval"=>"week", "name"=>"Example Rule"}], "stateCode"=>"SP", "streetLine1"=>"Av. Paulista, 200", "streetLine2"=>"Apto. 123", "tags"=>["travel", "food"], "zipCode"=>"01311-200"}]}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Content-Type | string |
RESPONSES
status: OK
{"cards":[{"binId":"53810202","city":"Sao Paulo","created":"2022-05-17T20:00:37.619527+00:00","displayName":"ANTHONY STARK","district":"Bela Vista","expiration":"****-**-**T**:**:**.******+00:00","holderExternalId":"my-entity/123","holderId":"4843929958612992","holderName":"Tony Stark","holderTaxId":"012.345.678-90","id":"5701684319748096","number":"**** **** **** 3714","rules":[{"amount":900000,"currencyCode":"BRL","id":"5138734366326784","interval":"week","name":"Example Rule"}],"securityCode":"***","stateCode":"SP","status":"active","streetLine1":"Av. Paulista, 200","streetLine2":"Apto. 123","tags":["travel","food"],"type":"virtual","updated":"2022-05-17T20:00:37.666247+00:00","zipCode":"01311-200"}],"message":"Card(s) successfully created"}