API REFERENCE
...
Instant payment
Create a payment initiation with whitelabel
1 min
{ "name" "whitelabel", "method" "post", "url" "https //api sandbox klavi ai/payment/customer/v1/instant/payment links", "description" "use /payment links endpoint in white label mode to return a token, a starting paymenturl and a initiation id ", "tab" "examples", "examples" { "languages" \[ { "id" "fqvm8vj3gyvgr0gsevmh9", "language" "curl", "code" "curl location 'https //api sandbox klavi ai/payment/customer/v1/instant/payment links' \\\\\n header 'accept application/json' \\\\\n header 'content type application/json' \\\\\n data '{\n \\"accesskey\\" \\"string\\",\n \\"secretkey\\" \\"string\\",\n \\"payment\\" {\n \\"clientrequestid\\" \\"string\\",\n \\"customer\\" {\n \\"identifiertype\\" \\"string\\",\n \\"identifier\\" \\"string\\",\n \\"name\\" \\"string\\",\n \\"phone\\" \\"string\\",\n \\"email\\" \\"string\\"\n },\n \\"loggedusercpf\\" \\"string\\",\n \\"ibgetowncode\\" \\"string\\",\n \\"proxy\\" \\"string\\",\n \\"qrcode\\" \\"string\\",\n \\"inittype\\" \\"string\\",\n \\"amount\\" \\"string\\",\n \\"currency\\" \\"string\\",\n \\"redirecturl\\" \\"string\\",\n \\"remittanceinformation\\" \\"string\\",\n \\"institutionid\\" \\"string\\",\n \\"debtoraccount\\" {\n \\"ispb\\" \\"string\\",\n \\"issuer\\" \\"string\\",\n \\"number\\" \\"string\\",\n \\"accounttype\\" \\"string\\"\n },\n \\"creditoraccount\\" {\n \\"ispb\\" \\"string\\",\n \\"issuer\\" \\"string\\",\n \\"number\\" \\"string\\",\n \\"accounttype\\" \\"string\\",\n \\"holder\\" {\n \\"identifiertype\\" \\"string\\",\n \\"identifier\\" \\"string\\",\n \\"name\\" \\"string\\"\n }\n },\n \\"externalinfo\\" \\"object\\"\n }\n}'", "customlabel" "" }, { "id" "sccljsdninfn7a hjqlpk", "language" "nodejs", "code" "var request = require('request');\nvar options = {\n 'method' 'post',\n 'url' 'https //api sandbox klavi ai/payment/customer/v1/instant/payment links',\n 'headers' {\n 'accept' 'application/json',\n 'content type' 'application/json'\n },\n body json stringify({\n \\"accesskey\\" \\"string\\",\n \\"secretkey\\" \\"string\\",\n \\"payment\\" {\n \\"clientrequestid\\" \\"string\\",\n \\"customer\\" {\n \\"identifiertype\\" \\"string\\",\n \\"identifier\\" \\"string\\",\n \\"name\\" \\"string\\",\n \\"phone\\" \\"string\\",\n \\"email\\" \\"string\\"\n },\n \\"loggedusercpf\\" \\"string\\",\n \\"ibgetowncode\\" \\"string\\",\n \\"proxy\\" \\"string\\",\n \\"qrcode\\" \\"string\\",\n \\"inittype\\" \\"string\\",\n \\"amount\\" \\"string\\",\n \\"currency\\" \\"string\\",\n \\"redirecturl\\" \\"string\\",\n \\"remittanceinformation\\" \\"string\\",\n \\"institutionid\\" \\"string\\",\n \\"debtoraccount\\" {\n \\"ispb\\" \\"string\\",\n \\"issuer\\" \\"string\\",\n \\"number\\" \\"string\\",\n \\"accounttype\\" \\"string\\"\n },\n \\"creditoraccount\\" {\n \\"ispb\\" \\"string\\",\n \\"issuer\\" \\"string\\",\n \\"number\\" \\"string\\",\n \\"accounttype\\" \\"string\\",\n \\"holder\\" {\n \\"identifiertype\\" \\"string\\",\n \\"identifier\\" \\"string\\",\n \\"name\\" \\"string\\"\n }\n },\n \\"externalinfo\\" \\"object\\"\n }\n })\n\n};\nrequest(options, function (error, response) {\n if (error) throw new error(error);\n console log(response body);\n});\n", "customlabel" "" }, { "id" "7pysstmodtbnvzpds1ko2", "language" "javascript", "code" "var myheaders = new headers();\nmyheaders append(\\"accept\\", \\"application/json\\");\nmyheaders append(\\"content type\\", \\"application/json\\");\n\nvar raw = json stringify({\n \\"accesskey\\" \\"string\\",\n \\"secretkey\\" \\"string\\",\n \\"payment\\" {\n \\"clientrequestid\\" \\"string\\",\n \\"customer\\" {\n \\"identifiertype\\" \\"string\\",\n \\"identifier\\" \\"string\\",\n \\"name\\" \\"string\\",\n \\"phone\\" \\"string\\",\n \\"email\\" \\"string\\"\n },\n \\"loggedusercpf\\" \\"string\\",\n \\"ibgetowncode\\" \\"string\\",\n \\"proxy\\" \\"string\\",\n \\"qrcode\\" \\"string\\",\n \\"inittype\\" \\"string\\",\n \\"amount\\" \\"string\\",\n \\"currency\\" \\"string\\",\n \\"redirecturl\\" \\"string\\",\n \\"remittanceinformation\\" \\"string\\",\n \\"institutionid\\" \\"string\\",\n \\"debtoraccount\\" {\n \\"ispb\\" \\"string\\",\n \\"issuer\\" \\"string\\",\n \\"number\\" \\"string\\",\n \\"accounttype\\" \\"string\\"\n },\n \\"creditoraccount\\" {\n \\"ispb\\" \\"string\\",\n \\"issuer\\" \\"string\\",\n \\"number\\" \\"string\\",\n \\"accounttype\\" \\"string\\",\n \\"holder\\" {\n \\"identifiertype\\" \\"string\\",\n \\"identifier\\" \\"string\\",\n \\"name\\" \\"string\\"\n }\n },\n \\"externalinfo\\" \\"object\\"\n }\n});\n\nvar requestoptions = {\n method 'post',\n headers myheaders,\n body raw,\n redirect 'follow'\n};\n\nfetch(\\"https //api sandbox klavi ai/payment/customer/v1/instant/payment links\\", requestoptions)\n then(response => response text())\n then(result => console log(result))\n catch(error => console log('error', error));", "customlabel" "" }, { "id" "5w fd3rcmqxildqr 0euf", "language" "python", "code" "import requests\nimport json\n\nurl = \\"https //api sandbox klavi ai/payment/customer/v1/instant/payment links\\"\n\npayload = json dumps({\n \\"accesskey\\" \\"string\\",\n \\"secretkey\\" \\"string\\",\n \\"payment\\" {\n \\"clientrequestid\\" \\"string\\",\n \\"customer\\" {\n \\"identifiertype\\" \\"string\\",\n \\"identifier\\" \\"string\\",\n \\"name\\" \\"string\\",\n \\"phone\\" \\"string\\",\n \\"email\\" \\"string\\"\n },\n \\"loggedusercpf\\" \\"string\\",\n \\"ibgetowncode\\" \\"string\\",\n \\"proxy\\" \\"string\\",\n \\"qrcode\\" \\"string\\",\n \\"inittype\\" \\"string\\",\n \\"amount\\" \\"string\\",\n \\"currency\\" \\"string\\",\n \\"redirecturl\\" \\"string\\",\n \\"remittanceinformation\\" \\"string\\",\n \\"institutionid\\" \\"string\\",\n \\"debtoraccount\\" {\n \\"ispb\\" \\"string\\",\n \\"issuer\\" \\"string\\",\n \\"number\\" \\"string\\",\n \\"accounttype\\" \\"string\\"\n },\n \\"creditoraccount\\" {\n \\"ispb\\" \\"string\\",\n \\"issuer\\" \\"string\\",\n \\"number\\" \\"string\\",\n \\"accounttype\\" \\"string\\",\n \\"holder\\" {\n \\"identifiertype\\" \\"string\\",\n \\"identifier\\" \\"string\\",\n \\"name\\" \\"string\\"\n }\n },\n \\"externalinfo\\" \\"object\\"\n }\n})\nheaders = {\n 'accept' 'application/json',\n 'content type' 'application/json'\n}\n\nresponse = requests request(\\"post\\", url, headers=headers, data=payload)\n\nprint(response text)\n", "customlabel" "" }, { "id" "yjzjmyia47sevtpwasfui", "language" "ruby", "code" "require \\"uri\\"\nrequire \\"json\\"\nrequire \\"net/http\"\n\nurl = uri(\\"https //api sandbox klavi ai/payment/customer/v1/instant/payment links\\")\n\nhttps = net http new(url host, url port)\nhttps use ssl = true\n\nrequest = net http post new(url)\nrequest\[\\"accept\\"] = \\"application/json\\"\nrequest\[\\"content type\\"] = \\"application/json\\"\nrequest body = json dump({\n \\"accesskey\\" \\"string\\",\n \\"secretkey\\" \\"string\\",\n \\"payment\\" {\n \\"clientrequestid\\" \\"string\\",\n \\"customer\\" {\n \\"identifiertype\\" \\"string\\",\n \\"identifier\\" \\"string\\",\n \\"name\\" \\"string\\",\n \\"phone\\" \\"string\\",\n \\"email\\" \\"string\\"\n },\n \\"loggedusercpf\\" \\"string\\",\n \\"ibgetowncode\\" \\"string\\",\n \\"proxy\\" \\"string\\",\n \\"qrcode\\" \\"string\\",\n \\"inittype\\" \\"string\\",\n \\"amount\\" \\"string\\",\n \\"currency\\" \\"string\\",\n \\"redirecturl\\" \\"string\\",\n \\"remittanceinformation\\" \\"string\\",\n \\"institutionid\\" \\"string\\",\n \\"debtoraccount\\" {\n \\"ispb\\" \\"string\\",\n \\"issuer\\" \\"string\\",\n \\"number\\" \\"string\\",\n \\"accounttype\\" \\"string\\"\n },\n \\"creditoraccount\\" {\n \\"ispb\\" \\"string\\",\n \\"issuer\\" \\"string\\",\n \\"number\\" \\"string\\",\n \\"accounttype\\" \\"string\\",\n \\"holder\\" {\n \\"identifiertype\\" \\"string\\",\n \\"identifier\\" \\"string\\",\n \\"name\\" \\"string\\"\n }\n },\n \\"externalinfo\\" \\"object\\"\n }\n})\n\nresponse = https request(request)\nputs response read body\n", "customlabel" "" } ], "selectedlanguageid" "fqvm8vj3gyvgr0gsevmh9" }, "results" { "languages" \[ { "id" "umvkfvj8 d7 snmhpijk", "language" "200", "customlabel" "", "code" "{\n \\"id\\" \\"fcb72e3a b346 4f71 b044 971dc23232c9\\",\n \\"paymenturl\\" \\"https //payment test klavi ai/?v=rvgvvvddoyir81gywjx9h1kbk55\\",\n}" } ], "selectedlanguageid" "umvkfvj8 d7 snmhpijk" }, "request" { "pathparameters" \[], "queryparameters" \[], "headerparameters" \[], "bodydataparameters" \[ { "name" "accesskey", "kind" "required", "type" "string", "description" "pre generated by klavi for partner" }, { "name" "secretkey", "kind" "required", "type" "string", "description" "pre generated by klavi for partner", "children" \[] }, { "name" "payment", "kind" "required", "type" "object", "description" "payment object", "" "required", "children" \[ { "name" "clientrequestid", "kind" "required", "type" "string", "description" "your internal orderid only can be used for once" }, { "name" "customer", "kind" "optional", "type" "object", "description" "user (natural person) who is logged in to the payment initiator institution", "children" \[ { "name" "identifiertype", "kind" "required", "type" "string", "description" "type of the user identification document cnpj or cpf\nif value is cpf \nmaxlength 3\nexample cpf\npattern ^\[a z]{3}$\n\nif value is cnpj\nmaxlength 4\nexample cnpj\npattern ^\[a z]{4}$" }, { "name" "identifier", "kind" "required", "type" "string", "description" "the number of the user identification document\nif identifiertype value is cpf \nmaxlength 11\nexample 11111111111\npattern ^\\\d{11}$\n\nif identifiertype value is cnpj \nmaxlength 14\nexample 11111111111111\npattern ^\\\d{14}$" }, { "name" "name", "kind" "optional", "type" "string", "description" "username" }, { "name" "phone", "kind" "optional", "type" "string", "description" "user's phone number" }, { "name" "email", "kind" "optional", "type" "string", "description" "user's email" } ] }, { "name" "loggedusercpf", "kind" "optional", "type" "string", "description" "user (natural person) who is logged in to the payment initiator institution \nmaxlength 11\nexample 11111111111\npattern ^\\\d{11}$\n\[restriction] required if customer identifiertype is cnpj" }, { "name" "ibgetowncode", "kind" "optional", "type" "string", "description" "ibge town code\nminlength 7\nmaxlength 7\npattern ^\\\d{7}$\nexample 5300108" }, { "name" "proxy", "kind" "optional", "type" "string", "description" "pix key\nmaxlength 77\npattern \[\\\w\\\w\\\s] \nexample 12345678901\nthe types of keys can be phone, e mail, cpf/cnpj or random key \nin the case of a mobile phone, it must be informed in the e 1641 standard \nin the case of e mail, it must have the format xxxxxxxx\@xxxxxxx xxx( xx) and a maximum of 77 characters \nin the case of cpf, it must be informed with 11 numbers, without dots or dashes in the case of cnpj, it must be informed with 14 numbers, without dots or dashes \n\[restriction] if inittype is pix manu, the proxy field should not be filled in if inittype is pix inic, pix dict, pix qrcode, the proxy field should always be filled with the pix key " }, { "name" "qrcode", "kind" "optional", "type" "string", "description" "qr code\nmaxlength 512\npattern \[\\\w\\\w\\\s] \nexample 00020104141234567890123426660014br gov bcb pix014466756c616e6f32303139406578616d706c652e636f6d27300012 br com outro011001234567895204000053039865406123 455802br5915nomedorecebedor6008brasilia61087007490062 530515rp12345678 201950300017br gov bcb brcode01051 0 080450014br gov bcb pix0123padrao url pix/0123ab cd81390012br com outro01190123 abcd 3456 wxyz6304eb76\nthis field should be in utf 8 format \n\[restriction] required for pix qrcode payments, with a maximum size of 512 bytes " }, { "name" "inittype", "kind" "optional", "type" "string", "description" "payment initiation type \npix inic pre registration of payee's account\npix manu the creditor object must be sent with all payee information \npix dict the pixkey field represents creditor information \npix qrcode the qrcode field represents creditor information " }, { "name" "amount", "kind" "required", "type" "string", "description" "amount that will be paid by the user\nminlength 4\nmaxlength 19\npattern ^((\\\d{1,16}\\\\ \\\d{2}))$\nexample 100000 12\n\[restriction] the value with 2 decimal places " }, { "name" "currency", "kind" "required", "type" "string", "description" "maxlength 3\npattern ^(\[a z]{3})$\nexample brl\nnational currency code according to iso 4217, i e , 'brl' all reported monetary values are represented with the current currency of brazil " }, { "name" "redirecturl", "kind" "optional", "type" "string", "description" "the url redirected after completing user authentication and consent in an institutional environment " }, { "name" "remittanceinformation", "kind" "optional", "type" "string", "description" "payment description\nmaxlength 140\npattern \[\\\w\\\w\\\s] \nexample pagamento da nota xpto035 002 \nit must be filled in whenever the paying user enters some additional information in a payment, to be sent to the recipient " }, { "name" "institutionid", "kind" "optional", "type" "string", "description" "id from the bank chosen by the user" }, { "name" "debtoraccount", "kind" "optional", "type" "object", "description" "payer's origin account information", "children" \[ { "name" "ispb", "kind" "required", "type" "string", "description" "minlength 8\nmaxlength 8\npattern ^\[0 9]{8}$\nexample 12345678\nit must be filled in with the ispb (brazilian payment system identifier) of the spi participant (instant payment system) with numbers only " }, { "name" "issuer", "kind" "optional", "type" "string", "description" "minlength 1\nmaxlength 4\npattern ^\[0 9]{1,4}$\nexample 1774\ncode of the agency issuing the account without digit \n \[restriction] mandatory for the following account types cacc (conta deposito a vista) and svgs (conta poupanca) " }, { "name" "number", "kind" "required", "type" "string", "description" "minlength 1\nmaxlength 20\npattern ^\[0 9]{1,20}$\nexample 1234567890\nit must be filled in with the paying user's transactional account number, with verification digit (if any),\nif there is an alphanumeric value, it should be converted to 0 " }, { "name" "accounttype", "kind" "required", "type" "string", "description" "types of accounts used for payment \nexample cacc\nenum \[ cacc, svgs, tran]\n cacc current current account\n svgs savings saving account\n tran transactingaccount prepaid payment account" } ] }, { "name" "creditoraccount", "kind" "optional", "type" "object", "description" "required if mthod = pix manu", "children" \[ { "name" "ispb", "kind" "optional", "type" "string", "description" "minlength 8\nmaxlength 8\npattern ^\[0 9]{8}$\nexample 12345678\nit must be filled in with the ispb (brazilian payment system identifier) of the spi participant (instant payment system) with numbers only " }, { "name" "issuer", "kind" "optional", "type" "string", "description" "minlength 1\nmaxlength 4\npattern ^\[0 9]{1,4}$\nexample 1774\ncode of the agency issuing the account without digit \n \[restriction] mandatory for the following account types cacc (conta deposito a vista) and svgs (conta poupanca) " }, { "name" "number", "kind" "required", "type" "string", "description" "minlength 1\nmaxlength 20\npattern ^\[0 9]{1,20}$\nexample 1234567890\nit must be filled in with the paying user's transactional account number, with verification digit (if any),\nif there is an alphanumeric value, it should be converted to 0 " }, { "name" "accounttype", "kind" "required", "type" "string", "description" "types of accounts used for payment \nexample cacc\nenum \[ cacc, svgs, tran]\n cacc current current account\n svgs savings saving account\n tran transactingaccount prepaid payment account" }, { "name" "holder", "kind" "required", "type" "object", "description" "required if inittype is pix manu", "children" \[ { "name" "identifiertype", "kind" "required", "type" "string", "description" "type of the user identification document cnpj or cpf\nif value is cpf \nmaxlength 3\nexample cpf\npattern ^\[a z]{3}$\n\nif value is cnpj\nmaxlength 4\nexample cnpj\npattern ^\[a z]{4}$" }, { "name" "identifier", "kind" "required", "type" "string", "description" "the number of the user identification document\nif identifiertype value is cpf \nmaxlength 11\nexample 11111111111\npattern ^\\\d{11}$\n\nif identifiertype value is cnpj \nmaxlength 14\nexample 11111111111111\npattern ^\\\d{14}$" }, { "name" "name", "kind" "required", "type" "string", "description" "username" } ] } ] }, { "name" "externalinfo", "kind" "optional", "type" "object", "description" "metadata, user customizable" } ], "schema" \[ { "name" "clientrequestid", "kind" "required", "type" "string", "description" "your internal orderid only can be used for once" }, { "name" "customer", "kind" "optional", "type" "object", "description" "user (natural person) who is logged in to the payment initiator institution", "children" \[ { "name" "identifiertype", "kind" "required", "type" "string", "description" "type of the user identification document cnpj or cpf\nif value is cpf \nmaxlength 3\nexample cpf\npattern ^\[a z]{3}$\n\nif value is cnpj\nmaxlength 4\nexample cnpj\npattern ^\[a z]{4}$" }, { "name" "identifier", "kind" "required", "type" "string", "description" "the number of the user identification document\nif identifiertype value is cpf \nmaxlength 11\nexample 11111111111\npattern ^\\\d{11}$\n\nif identifiertype value is cnpj \nmaxlength 14\nexample 11111111111111\npattern ^\\\d{14}$" }, { "name" "name", "kind" "optional", "type" "string", "description" "username" }, { "name" "phone", "kind" "optional", "type" "string", "description" "user's phone number" }, { "name" "email", "kind" "optional", "type" "string", "description" "user's email" } ] }, { "name" "loggedusercpf", "kind" "optional", "type" "string", "description" "user (natural person) who is logged in to the payment initiator institution \nmaxlength 11\nexample 11111111111\npattern ^\\\d{11}$\n\[restriction] required if customer identifiertype is cnpj" }, { "name" "ibgetowncode", "kind" "optional", "type" "string", "description" "ibge town code\nminlength 7\nmaxlength 7\npattern ^\\\d{7}$\nexample 5300108" }, { "name" "proxy", "kind" "optional", "type" "string", "description" "pix key\nmaxlength 77\npattern \[\\\w\\\w\\\s] \nexample 12345678901\nthe types of keys can be phone, e mail, cpf/cnpj or random key \nin the case of a mobile phone, it must be informed in the e 1641 standard \nin the case of e mail, it must have the format xxxxxxxx\@xxxxxxx xxx( xx) and a maximum of 77 characters \nin the case of cpf, it must be informed with 11 numbers, without dots or dashes in the case of cnpj, it must be informed with 14 numbers, without dots or dashes \n\[restriction] if inittype is pix manu, the proxy field should not be filled in if inittype is pix inic, pix dict, pix qrcode, the proxy field should always be filled with the pix key " }, { "name" "qrcode", "kind" "optional", "type" "string", "description" "qr code\nmaxlength 512\npattern \[\\\w\\\w\\\s] \nexample 00020104141234567890123426660014br gov bcb pix014466756c616e6f32303139406578616d706c652e636f6d27300012 br com outro011001234567895204000053039865406123 455802br5915nomedorecebedor6008brasilia61087007490062 530515rp12345678 201950300017br gov bcb brcode01051 0 080450014br gov bcb pix0123padrao url pix/0123ab cd81390012br com outro01190123 abcd 3456 wxyz6304eb76\nthis field should be in utf 8 format \n\[restriction] required for pix qrcode payments, with a maximum size of 512 bytes " }, { "name" "inittype", "kind" "optional", "type" "string", "description" "payment initiation type \npix inic pre registration of payee's account\npix manu the creditor object must be sent with all payee information \npix dict the pixkey field represents creditor information \npix qrcode the qrcode field represents creditor information " }, { "name" "amount", "kind" "required", "type" "string", "description" "amount that will be paid by the user\nminlength 4\nmaxlength 19\npattern ^((\\\d{1,16}\\\\ \\\d{2}))$\nexample 100000 12\n\[restriction] the value with 2 decimal places " }, { "name" "currency", "kind" "required", "type" "string", "description" "maxlength 3\npattern ^(\[a z]{3})$\nexample brl\nnational currency code according to iso 4217, i e , 'brl' all reported monetary values are represented with the current currency of brazil " }, { "name" "redirecturl", "kind" "optional", "type" "string", "description" "the url redirected after completing user authentication and consent in an institutional environment " }, { "name" "remittanceinformation", "kind" "optional", "type" "string", "description" "payment description\nmaxlength 140\npattern \[\\\w\\\w\\\s] \nexample pagamento da nota xpto035 002 \nit must be filled in whenever the paying user enters some additional information in a payment, to be sent to the recipient " }, { "name" "institutionid", "kind" "optional", "type" "string", "description" "id from the bank chosen by the user" }, { "name" "debtoraccount", "kind" "optional", "type" "object", "description" "payer's origin account information", "children" \[ { "name" "ispb", "kind" "required", "type" "string", "description" "minlength 8\nmaxlength 8\npattern ^\[0 9]{8}$\nexample 12345678\nit must be filled in with the ispb (brazilian payment system identifier) of the spi participant (instant payment system) with numbers only " }, { "name" "issuer", "kind" "optional", "type" "string", "description" "minlength 1\nmaxlength 4\npattern ^\[0 9]{1,4}$\nexample 1774\ncode of the agency issuing the account without digit \n \[restriction] mandatory for the following account types cacc (conta deposito a vista) and svgs (conta poupanca) " }, { "name" "number", "kind" "required", "type" "string", "description" "minlength 1\nmaxlength 20\npattern ^\[0 9]{1,20}$\nexample 1234567890\nit must be filled in with the paying user's transactional account number, with verification digit (if any),\nif there is an alphanumeric value, it should be converted to 0 " }, { "name" "accounttype", "kind" "required", "type" "string", "description" "types of accounts used for payment \nexample cacc\nenum \[ cacc, svgs, tran]\n cacc current current account\n svgs savings saving account\n tran transactingaccount prepaid payment account" } ] }, { "name" "creditoraccount", "kind" "optional", "type" "object", "description" "required if mthod = pix manu", "children" \[ { "name" "ispb", "kind" "optional", "type" "string", "description" "minlength 8\nmaxlength 8\npattern ^\[0 9]{8}$\nexample 12345678\nit must be filled in with the ispb (brazilian payment system identifier) of the spi participant (instant payment system) with numbers only " }, { "name" "issuer", "kind" "optional", "type" "string", "description" "minlength 1\nmaxlength 4\npattern ^\[0 9]{1,4}$\nexample 1774\ncode of the agency issuing the account without digit \n \[restriction] mandatory for the following account types cacc (conta deposito a vista) and svgs (conta poupanca) " }, { "name" "number", "kind" "required", "type" "string", "description" "minlength 1\nmaxlength 20\npattern ^\[0 9]{1,20}$\nexample 1234567890\nit must be filled in with the paying user's transactional account number, with verification digit (if any),\nif there is an alphanumeric value, it should be converted to 0 " }, { "name" "accounttype", "kind" "required", "type" "string", "description" "types of accounts used for payment \nexample cacc\nenum \[ cacc, svgs, tran]\n cacc current current account\n svgs savings saving account\n tran transactingaccount prepaid payment account" }, { "name" "holder", "kind" "required", "type" "object", "description" "required if inittype is pix manu", "children" \[ { "name" "identifiertype", "kind" "required", "type" "string", "description" "type of the user identification document cnpj or cpf\nif value is cpf \nmaxlength 3\nexample cpf\npattern ^\[a z]{3}$\n\nif value is cnpj\nmaxlength 4\nexample cnpj\npattern ^\[a z]{4}$" }, { "name" "identifier", "kind" "required", "type" "string", "description" "the number of the user identification document\nif identifiertype value is cpf \nmaxlength 11\nexample 11111111111\npattern ^\\\d{11}$\n\nif identifiertype value is cnpj \nmaxlength 14\nexample 11111111111111\npattern ^\\\d{14}$" }, { "name" "name", "kind" "required", "type" "string", "description" "username" } ] } ] }, { "name" "externalinfo", "kind" "optional", "type" "object", "description" "metadata, user customizable" } ] } ], "formdataparameters" \[] }, "currentnewparameter" { "label" "body parameter", "value" "bodydataparameters" }, "response" \[ { "name" "id", "kind" "optional", "type" "string", "description" "id of the payment order" }, { "name" "paymenturl", "kind" "optional", "type" "string", "description" "dynamic url generated by klavi,use this link to redirect the user to complete the payment initiation flow", "children" \[] } ] } https //docs klavipay ai/docs/api reference/customer/auth/auth interface#code 200