Create billing account

1 import requests 2 3 url = "https://api.koywe.com/api/v1/billing/organizations/org_12345/merchants/mer_67890/billing-account" 4 5 payload = { 6 "country": "CHL", 7 "certificatePassword": "certificatePassword" 8 } 9 headers = { 10 "Authorization": "Bearer <token>", 11 "Content-Type": "application/json" 12 } 13 14 response = requests.post(url, json=payload, headers=headers) 15 16 print(response.json())

1 { 2 "merchantId": "mrc_31fd8637-f889-43fa-8b31-50d9296abfdc", 3 "slug": "republic", 4 "profile": { 5 "name": "Galactic Republic Trading", 6 "description": "1234 Main St, Coruscant", 7 "address": "1234 Main St, Coruscant", 8 "email": "galactic.republic@row.com", 9 "phone": "1234567890", 10 "url": "https://galacticrepublic.com", 11 "supportEmail": "galacticrepublic", 12 "supportPhone": "1234567890", 13 "supportUrl": "https://galacticrepublic.com/support", 14 "taxIdType": "RUT", 15 "taxIdNumber": "123456789", 16 "addressLine2": "Suite 100", 17 "city": "Springfield", 18 "postalCode": "90210", 19 "stateId": "st_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", 20 "State": { 21 "id": "id", 22 "name": "name", 23 "code": "code", 24 "countryId": "countryId" 25 }, 26 "countyId": "cnt_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", 27 "County": { 28 "id": "id", 29 "name": "name", 30 "code": "code", 31 "stateId": "stateId" 32 }, 33 "Country": { 34 "id": "id", 35 "name": "name", 36 "fullName": "fullName", 37 "Currency": {}, 38 "twoLetterIso": { 39 "key": "value" 40 } 41 }, 42 "state": "California" 43 }, 44 "businessType": "Galactic Republic Trading", 45 "businessStructure": "Galactic Republic Trading", 46 "capabilities": { 47 "payments": true, 48 "collections": true 49 }, 50 "chargesEnabled": true, 51 "countryId": "ctry_84b8b218-2777-4e7f-863e-7d0601ac289f", 52 "createdAt": "2024-07-01T22:40:22Z", 53 "defaultCurrencyId": "cur_8289dc19-e775-4c0c-a42a-e0da129e3b64", 54 "kybComplete": true, 55 "disabled": true, 56 "disabledReason": "N/D", 57 "Country": { 58 "id": "id", 59 "name": "name", 60 "fullName": "fullName", 61 "Currency": {}, 62 "twoLetterIso": { 63 "key": "value" 64 } 65 }, 66 "branding": { 67 "icon": "https://example.com/icon.png", 68 "logo": "https://example.com/logo.png", 69 "primaryColor": "#FF0000", 70 "secondaryColor": "#00FF00" 71 } 72 }

Creates a billing account and uploads digital certificate for digital signatures and invoicing

Path parameters

organizationIdstringRequired

Organization ID

merchantIdstringRequired

Merchant ID

Request

This endpoint expects an object.

countryenumRequired

Country for the certificate

certificatePasswordstringRequired

The password of the certificate - Required for CL and MX

certificateFilestringOptional

Certificate file content (Base64) - Required for CL

certificateKeystringOptional

Certificate key file content (Base64) - Required for MX

certificateCerstringOptional

Certificate .cer file content (Base64) - Required for MX

testSetIdstringOptional

Test set id - Required for COL

formRutstringOptional

Form RUT .pdf file content (Base64) - Required for COL

Response

Create billing account and upload digital certificate for digital signatures and invoicing

merchantIdstring

slugstring

profileobject

businessTypestring

businessStructurestring

capabilitiesobject

chargesEnabledboolean

countryIdstring

createdAtdatetime

defaultCurrencyIdstring

kybCompleteboolean

disabledboolean

disabledReasonstring

Countryobject or null

brandingobject or null

Create billing account

Path parameters

Headers

Request

Response

Errors