Create issuing cards

POST {{baseInfraUrl}}/{{version}}/issuing-card

Create Issuing Cards with specific spending rules.

ParametersValue TypeDescription
holderNameREQUIREDCardholder's name. Example: name=Tony Stark
holderTaxIdREQUIREDCardholder's CPF (11 digits formatted or unformatted) or CNPJ (14 digits formatted or unformatted). Example: holderTaxId=012.345.678-90
holderExternalIdREQUIREDCardholder's unique id, generated by the user to avoid duplicated holders. Example: my-entity/123
displayNameOPTIONALCard display name. Example: displayName=ANTHONY STARK.
rulesOPTIONALSpending rules for the Issuing Card. List of dictionaries or a list of Issuing Rule objects containing: amount, currencyCode, id, interval and name.
binIdOPTIONALBin id to which the card is bound. Example: binId=538102.
tagsOPTIONALList of strings for tagging. All tags will be converted to lowercase. Example: tags=[travel, food].
streetLine1OPTIONALCardholder's main address. Example: streetLine1=Av. Paulista, 200.
streetLine2OPTIONALCardholder's address complement. Example: streetLine2=Apto. 123.
districtOPTIONALCardholder's address district / neighbourhood. Example: district=Bela Vista.
cityOPTIONALCardholder's address city. Example: district=Sao Paulo.
stateCodeOPTIONALCardholder's address state code. Example: stateCode=SP.
zipCodeOPTIONALCardholder's address zip code. Example: zipCode=01311-200.

Request Params

KeyDatatypeRequiredDescription
expandstringFields 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

KeyDatatypeRequiredDescription
Content-Typestring

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"}