Customer Credit API
With Customer Credit your store can enable **credit payments** through the checkout. You can also control **invoices** and the **credit limits** of your clients. Learn more about Customer Credit in our [Help Center article](https://help.vtex.com/en/tracks/customer-credit-getting-started--1hCRg21lXYy2seOKgqQ2CC/36grlQ69NK6OCuioeekyCs). All requests need the **authorization header**. Additionally, y
Admin: update documentationGET
/api/creditcontrol/accounts
Search all accounts
Content-Type ( header , required ) — The Media type of the body of the request. Default value for payment provider protocol is application/jsonAccept ( header , required ) — Media type(s) that is/are acceptable for the response. Default value for payment provider protocol is application/jsonPOST
/api/creditcontrol/accounts
Open an Account
Accept ( header , required ) — Media type(s) that is/are acceptable for the response. Default value for payment provider protocol is application/jsonContent-Type ( header , required ) — The Media type of the body of the request. Default value for payment provider protocol is application/jsonPUT
/api/creditcontrol/accounts/{accountId}
Open or Change Account
accountId ( path , required ) — It must be an alphanumeric valueAccept ( header , required ) — Media type(s) that is/are acceptable for the response. Default value for payment provider protocol is application/jsonContent-Type ( header , required ) — The Media type of the body of the request. Default value for payment provider protocol is application/jsonDELETE
/api/creditcontrol/accounts/{creditAccountId}
Close an Account
creditAccountId ( path , required ) — Credit account's identifierAccept ( header , required ) — Media type(s) that is/are acceptable for the response. Default value for payment provider protocol is application/jsonContent-Type ( header , required ) — The Media type of the body of the request. Default value for payment provider protocol is application/jsonGET
/api/creditcontrol/accounts/{creditAccountId}
Retrieve an Account by Id
Content-Type ( header , required ) — The Media type of the body of the request. Default value for payment provider protocol is application/jsonAccept ( header , required ) — Media type(s) that is/are acceptable for the response. Default value for payment provider protocol is application/jsoncreditAccountId ( path , required ) PUT
/api/creditcontrol/accounts/{creditAccountId}
Update email and description of a account
creditAccountId ( path , required ) — Credit account's identificationAccept ( header , required ) — Media type(s) that is/are acceptable for the response. Default value for payment provider protocol is application/jsonContent-Type ( header , required ) — The Media type of the body of the request. Default value for payment provider protocol is application/jsonPUT
/api/creditcontrol/accounts/{creditAccountId}/creditlimit
Change credit limit of an Account
creditAccountId ( path , required ) — Credit account's identifierAccept ( header , required ) — Media type(s) that is/are acceptable for the response. Default value for payment provider protocol is application/jsonContent-Type ( header , required ) — The Media type of the body of the request. Default value for payment provider protocol is application/jsonPOST
/api/creditcontrol/accounts/{creditAccountId}/holders
Add an account Holder
creditAccountId ( path , required ) — Credit account's identificationAccept ( header , required ) — Media type(s) that is/are acceptable for the response. Default value for payment provider protocol is application/jsonContent-Type ( header , required ) — The Media type of the body of the request. Default value for payment provider protocol is application/jsonDELETE
/api/creditcontrol/accounts/{creditAccountId}/holders/{holderId}
Delete an account holder
Content-Type ( header , required ) — The Media type of the body of the request. Default value for payment provider protocol is application/jsonAccept ( header , required ) — Media type(s) that is/are acceptable for the response. Default value for payment provider protocol is application/jsoncreditAccountId ( path , required ) — Credit account's identificationholderId ( path , required ) GET
/api/creditcontrol/accounts/{creditAccountId}/invoices
Retrieve invoice by creditAccountId
Content-Type ( header , required ) — The Media type of the body of the request. Default value for payment provider protocol is application/jsonAccept ( header , required ) — Media type(s) that is/are acceptable for the response. Default value for payment provider protocol is application/jsoncreditAccountId ( path , required ) DELETE
/api/creditcontrol/accounts/{creditAccountId}/invoices/{invoiceId}
Cancel Invoice
Content-Type ( header , required ) — The Media type of the body of the request. Default value for payment provider protocol is application/jsonAccept ( header , required ) — Media type(s) that is/are acceptable for the response. Default value for payment provider protocol is application/jsoncreditAccountId ( path , required ) — Credit account's identificationinvoiceId ( path , required ) GET
/api/creditcontrol/accounts/{creditAccountId}/invoices/{invoiceId}
Retrieve Invoice by Id
Content-Type ( header , required ) — The Media type of the body of the request. Default value for payment provider protocol is application/jsonAccept ( header , required ) — Media type(s) that is/are acceptable for the response. Default value for payment provider protocol is application/jsoncreditAccountId ( path , required ) — Credit account's identificationinvoiceId ( path , required ) PUT
/api/creditcontrol/accounts/{creditAccountId}/invoices/{invoiceId}
Change Invoice
creditAccountId ( path , required ) — Credit account's identificationinvoiceId ( path , required ) friendlyId ( query ) — Invoice's identificationAccept ( header , required ) — Media type(s) that is/are acceptable for the response. Default value for payment provider protocol is application/jsonContent-Type ( header , required ) — The Media type of the body of the request. Default value for payment provider protocol is application/jsonPOST
/api/creditcontrol/accounts/{creditAccountId}/invoices/{invoiceId}/payments
Mark an invoice as Paid
creditAccountId ( path , required ) — Credit account's identificationinvoiceId ( path , required ) Accept ( header , required ) — Media type(s) that is/are acceptable for the response. Default value for payment provider protocol is application/jsonContent-Type ( header , required ) — The Media type of the body of the request. Default value for payment provider protocol is application/jsonPUT
/api/creditcontrol/accounts/{creditAccountId}/invoices/{invoiceId}/postponement
Postpone an invoice
creditAccountId ( path , required ) — Credit account's identificationinvoiceId ( path , required ) Accept ( header , required ) — Media type(s) that is/are acceptable for the response. Default value for payment provider protocol is application/jsonContent-Type ( header , required ) — The Media type of the body of the request. Default value for payment provider protocol is application/jsonGET
/api/creditcontrol/accounts/{creditAccountId}/statements
Account statements
Content-Type ( header , required ) — The Media type of the body of the request. Default value for payment provider protocol is application/jsonAccept ( header , required ) — Media type(s) that is/are acceptable for the response. Default value for payment provider protocol is application/jsoncreditAccountId ( path , required ) PUT
/api/creditcontrol/accounts/{creditAccountId}/statements/{statementId}
Decrease balance of an account
creditAccountId ( path , required ) — Credit account's identificationstatementId ( path , required ) Accept ( header , required ) — Media type(s) that is/are acceptable for the response. Default value for payment provider protocol is application/jsonContent-Type ( header , required ) — The Media type of the body of the request. Default value for payment provider protocol is application/jsonPUT
/api/creditcontrol/accounts/{creditAccountId}/tolerance
Change tolerance of an account
creditAccountId ( path , required ) — Credit account's identificationAccept ( header , required ) — Media type(s) that is/are acceptable for the response. Default value for payment provider protocol is application/jsonContent-Type ( header , required ) — The Media type of the body of the request. Default value for payment provider protocol is application/jsonPOST
/api/creditcontrol/accounts/{creditAccountId}/transaction
Create a Pre Authorization
creditAccountId ( path , required ) — Credit account's identificationAccept ( header , required ) — Media type(s) that is/are acceptable for the response. Default value for payment provider protocol is application/jsonContent-Type ( header , required ) — The Media type of the body of the request. Default value for payment provider protocol is application/jsonDELETE
/api/creditcontrol/accounts/{creditAccountId}/transactions/{transactionId}
Cancel a Pre Authorization
Content-Type ( header , required ) — The Media type of the body of the request. Default value for payment provider protocol is application/jsonAccept ( header , required ) — Media type(s) that is/are acceptable for the response. Default value for payment provider protocol is application/jsoncreditAccountId ( path , required ) — Credit account's identificationtransactionId ( path , required ) PUT
/api/creditcontrol/accounts/{creditAccountId}/transactions/{transactionId}
Create a Pre Authorization (using id)
creditAccountId ( path , required ) — Credit account's identificationtransactionId ( path , required ) Accept ( header , required ) — Media type(s) that is/are acceptable for the response. Default value for payment provider protocol is application/jsonContent-Type ( header , required ) — The Media type of the body of the request. Default value for payment provider protocol is application/jsonPOST
/api/creditcontrol/accounts/{creditAccountId}/transactions/{transactionId}/refunds
Partial or Total Refund a Settlement
creditAccountId ( path , required ) — Credit account's identificationtransactionId ( path , required ) Accept ( header , required ) — Media type(s) that is/are acceptable for the response. Default value for payment provider protocol is application/jsonContent-Type ( header , required ) — The Media type of the body of the request. Default value for payment provider protocol is application/jsonPUT
/api/creditcontrol/accounts/{creditAccountId}/transactions/{transactionId}/settlement
Create or Update Settlement
creditAccountId ( path , required ) — Credit account's identificationtransactionId ( path , required ) Accept ( header , required ) — Media type(s) that is/are acceptable for the response. Default value for payment provider protocol is application/jsonContent-Type ( header , required ) — The Media type of the body of the request. Default value for payment provider protocol is application/jsonGET
/api/creditcontrol/invoices
Search all invoices
Content-Type ( header , required ) — The Media type of the body of the request. Default value for payment provider protocol is application/jsonAccept ( header , required ) — Media type(s) that is/are acceptable for the response. Default value for payment provider protocol is application/jsonfrom ( query ) to ( query ) createdDateFrom ( query ) createdDateTo ( query ) value ( query ) — Invoice's value. It must be completed with a decimal value.status ( query ) — Invoice's status. It must be completed with "Paid", "Cancelled" or "Open" value.friendlyId ( query ) — Invoice's identifiercreditAccountId ( query ) — Credit account's identifierGET
/api/creditcontrol/storeconfig
Retrieve store configuration
Content-Type ( header , required ) — The Media type of the body of the request. Default value for payment provider protocol is application/jsonAccept ( header , required ) — Media type(s) that is/are acceptable for the response. Default value for payment provider protocol is application/jsonPUT
/api/creditcontrol/storeconfig
Create or change store configuration
Accept ( header , required ) — Media type(s) that is/are acceptable for the response. Default value for payment provider protocol is application/jsonContent-Type ( header , required ) — The Media type of the body of the request. Default value for payment provider protocol is application/json
26 endpoints auto-detected
Authentication
This API uses an API key, passed in the "X-VTEX-API-AppKey" header. No OAuth required.
curl -X GET \
"https://vtex.local/api/creditcontrol/accounts" \
-H "X-VTEX-API-AppKey: YOUR_API_KEY"