Developer Portal
Developer portal provides the user access to Enfuce Payment APIs towards our Card as a Service (CaaS) platform. From developer portal user try our Payments APIs without any coding or access right requests from simple forms that send API requests directly from that portal. Currently Developer Portal supports Customer, Account, Card and Transaction API endpoints.
API explorer lets you f.ex. initiate transactions or fetch account information in a test environment as close to the production environment as possible. API explorer is linked towards our Demo environment and Template configuration. The entities created from API explorer can be then accessed from Sandbox, so you won’t have to remember the IDs that are needed in API calls.
API explorer
Quick how to use it
- Start by creating a private customer with Create private customer API. Customer is the first thing you need always to be able to create any other entities. You need to give following values.
- customerNumber (need to be unique, so come up with some own unique value),
- locale, use f.ex fi_FI
- regNo (need to be unique, can be same as customerNumber)
- address (inside that you need to set at least address1, city, country (A valid ISO-3166-1 alpha-3 country code f.ex. FIN), zipCode)
- firstname
- lastName
- Go to Sandbox Customers view, from here you can now find your newly created Customer
- From Actions select Add Account
- This will pre-populate customerID for you and default to a Prepaid account creation, there’s no mandatory fields needed for this step, so you can just create account as-is (you can always update values later)
- Go to Sandbox Accounts view, from here you can now find your newly created Account
- From Actions select Add Card
- This will pre-populate customerID and accountID for you and default to a Create a virtual VISA branded card, you need to set embossing firstName and lastName to be able to create the card.
- Congratulations! You have created your first simple Customer-Account-Card structure. This is the simplest setup that is needed to be able to start using the card. More complexity can be the added to this same structure. You can f.ex. add more card under this account or link more accounts to this same customer.
- Now you can f.ex. Post test authorization to given card with Transactions API, try to Update APIs or test Get APIs for Customer, Account or Card.
Customers
Customer endpoints enables you to create private and corporate customers. With Get operations you can see what kind of information is returned with Customer API. You can also update existing customer data with Update endpoints.
NOTE! Current Template configuration does not have support for Corporate customers as Account owner. System supports that, but this requires a specific account configuration and account templates does not have that available currently, so use private customers for account owners.
Accounts
Account endpoints enables you to create Credit, Prepaid and Debit accounts. With Get operations you can see what kind of information is returned with Account API. You can also update existing accounts data with Update endpoints.
Cards
Card endpoints enables you to create VISA and MasterCards with Virtual or Plastic types. With Get operations you can see what kind of information is returned with Card API. You can also update existing cards data with Update endpoints. There is also a special endpoint for Initiate card data retriaval, from which you can see what kind of information is returned on that API, but this endpoint requires special additional steps and those are not available currently in API explorer.
Transactions
Transaction endpoints enables you to create transactions for Account or Card. With Get operations you can see what kind of information is returned with Transaction API. You can also REVERSE certain types of transaction with Update endpoint.
For testing purposes the most useful endpoints are Post test transactions to given card and Post test authorizations given card.
Sandbox
The Sandbox shows only the items you have created with API Explorer.
Customers
Customers lists all the customer you have created with customer related API Explorer.
Create new
Create new directs you to Create private customer API Explorer endpoint. You can change that to Create corporate customer also, if needed.
Actions - View
Will direct you to Customer Portal, so you can try our Customer Portal also without any registrations. You will have Write accesses in Customer Portal, so you can also modify your Sandbox items via Customer Portal.
Actions - Update
Update will direct you to Update customer API Explorer endpoint. It will auto-populate the customer id, so you can quick test how update works. You need to give only the items you are interested in to update.
Actions - Get
Get will direct you to Get customer API Explorer endpoint. It will auto-populate the customer id, so you can quick test how get are work.
Actions - Add Account
Add Account will direct you to Create prepaid account API Explorer endpoint. It will auto-populate the customer id, so you can quick test how get are work. You can change to other account types also, if needed, but you will loose then customer id, so copy that before switching.
Accounts
Accounts lists all the accounts you have created with account related API Explorer.
Create new
Create new directs you to Create prepaid account API Explorer endpoint. You can change to other account types also, if needed.
Actions - View
Will direct you to Customer Portal, so you can try our Customer Portal also without any registrations. You will have Write accesses in Customer Portal, so you can also modify your Sandbox items via Customer Portal.
Actions - Update
Update will direct you to Update account API Explorer endpoint. It will auto-populate the account id, so you can quick test how update works. You need to give only the items you are interested in to update.
Actions - Get
Get will direct you to Get account API Explorer endpoint. It will auto-populate the account id, so you can quick test how get are work.
Actions - Add Card
Add Card will direct you to Create virtual VISA branded card API Explorer endpoint. It will auto-populate the account id and customer id (customer id is picked from account’s customer), so you can quick test how get are work. You can change to other card types also, if needed, but you will loose then account id and customer id, so copy that before switching.
Cards
Cards lists all the cards you have created with card related API Explorer.
Create new
Create new directs you to Create virtual VISA branded card API Explorer endpoint. You can change to other card types also, if needed.
Actions - View
Will direct you to Customer Portal, so you can try our Customer Portal also without any registrations. You will have Write accesses in Customer Portal, so you can also modify your Sandbox items via Customer Portal.
Actions - Update
Update will direct you to Update card API Explorer endpoint. It will auto-populate the card id, so you can quick test how update works. You need to give only the items you are interested in to update.
Actions - Get
Get will direct you to Get card API Explorer endpoint. It will auto-populate the card id, so you can quick test how get are work.
Transactions
Transactions lists all the transactions you have created with transactions related API Explorer.
Create new
Create new directs you to Post test transaction to given card API Explorer endpoint. You need to copy the card id from cards. If you want to have only authorization, use Post test authorization to given card.
Actions - View
Will direct you to Customer Portal, so you can try our Customer Portal also without any registrations. You will have Write accesses in Customer Portal, so you can also modify your Sandbox items via Customer Portal.