8 May 2023
AccountsAssetsAuthorizationCardsConsoleCorporate bankingData and reportingDisputesDocumentationMigrationsRetail bankingStatementsTransactions
Highlights
๐Disputes
Disputes can now be created for the ELO card network.
Create dispute and Create dispute installment endpoints now include fraud_type
, document_indicator
, and currency_code
fields.
๐New statements endpoints
New Change account overdue status endpoint can be used to change an accountโs overdue status back to normal.
The following new statements endpoints are available for updating, getting, and deleting program parameters that take an array of values:
๐Daily account account balance limits
New Get daily account balance limits endpoint is now available. The Get daily account balance limits guide has been updated accordingly.
๐Authorization validations
In Authorization validations, changed response codes for the ELO network:
- Custom code FAT - Old RC 63 - New RC 82
- Custom codes FR5, FRN, and FRE - Old RC 63 - New RC 82
- Custom code UBT - Old RC 78 - New RC 62
- Custom code BNW - Old RC 59 - New RC 62
- Custom code CPE - Old RC 14 - New RC 62
New validation code - FR3 - has been added. FR3 refers to an error message that may be displayed while processing a transaction with a card.
๐Corporate banking
The following new corporate banking endpoints support external_account_id
.
In the Payments group:
- Post payment enables you to submit payments to the platform.
- Schedule payment allows you to schedule payments on a specified future date.
- List scheduled payments lists all scheduled payments from an account.
- Get scheduled payments by ID enables you to find a specified payment by its ID.
- Cancel scheduled payment allows you to cancel a scheduled payment.
In the Accounts group:
- Update corporate account status enables you to update the corporate account status and all of its children.
- Rollback corporate account status enables roll back of a canceled account to an active status.
In the Transactions group:
- List transactions shows all transactions by a user on their account.
- Get transaction retrieves a transaction by a user on their account.
๐Banking reports
The new banking reports API from retail banking includes two endpoints:
- Get account annual fees report
- Get account income report
๐Transaction events
Transaction create-1 and update-1 events include the new authorization_tracking_id
field. This unique ID can be defined by the customer when creating a non-network transaction via API or can be created automatically while a network transaction is created, according to the Universally Unique Identifier (UUID) concept. Examples of possible values for the tracking ID are:
123e4567-e89b-12d3-a456-426614174200
00112233-4455-6677-8899-aabbccddeeff
Also, transaction events documentation is now in line with the new standards.
๐Accounting event field
In the accounting entry_creation-1 event, the new authorization_date
field is now available. The AuthorizationDate
field is also available in the accounting events report files.
๐Hold funds processing codes
You can now create processing codes for hold funds functionality. See Processing codes and transaction types for more information.
๐Migrations updates
- On the Migrate accounts endpoint, marked
acquisition_channel
as deprecated, updatedcollection_status
to consider onlyNORMAL
andOVERDUE
financial statuses (removed REFINANCING), and removedcid
andtenant
fields and all references to them. - On the Migrate PCI cards endpoint, updated the description, updated the server URL to
https://gw-pci.pismolabs.io/migrations
, and updated description formigration.id
. - On the Migrate cards endpoint, updated maximum length of the
printed_name
field to26
, changed thetype
field to only containPLASTIC
andVIRTUAL
(removed RECURRING and TEMPORARY). - On the Migrate transactions and Migrate statements endpoints, updated maximum length for
migration.id
from60
to100
. - The two PCI endpoints Migrate PCI cards and Migrate PCI cards Go Live now include the reminder note to use the
https://gw-pci.pismolabs.io
environment.
๐Orgs endpoints decommission
The following unused Orgs API endpoints have been deprecated:
Put - /v1/orgs/:orgId
Get - /v1/orgs/items
Get - /v1/orgs/:orgId/operations
Put - /v1/orgs/:orgId/operations
Get - /v1/parameter_types
Get - /v1/programstypes
Get - /v1/programs/:programId/parameterstypes
Get - /v1/programs/:programId/parameters/:parameterId
Put - /v1/programs/:programId/parameters/:parameterId
Get - /v1/programs/:programId/scheduled-parameters
Get - /v1/programs/:programId/scheduled-parameters/:parameterId
Post - /v1/programs/:programId/scheduled-parameters
Put - /v1/programs/:programId/scheduled-parameters/:parameterId
Patch - /v1/programs/:programId/scheduled-parameters/:parameterId
Post - /v1/programs
Put - /v1/programs/:programId
Post - /v1/programs/:programId/cedente/email
Post - /v1/programs/:programId/cedente/sms
Get - /v1/orgs/templates/:name
Post - /v1/orgs/templates/:name
Put - /v1/orgs/templates/:name
Get - /v2/orgs/:orgId/programs/:programId/email-templates/:templateName
Post - /v1/programs/:programId/program_transaction_types
Get - /v1/program_transaction_types/:programTransactionTypeId
Put - /v1/program_transaction_types/:programTransactionTypeId
Get - /v1/programs/:programId/program_transaction_types
The decommission schedule for these endpoints is as follows:
- May 2, 2023 - removal from the EXT environment
- May 17, 2023 - removal from the production environment
Documentation
๐Developer portal usability
The following updates now make the Pismo developer portal more user-friendly:
- Introduced the show/hide feature to expand the section.
- Developed a solution for displaying and formatting larger tables.
- Made the top navigation bar sticky.
- Updated callout box icons and format.
- Made the search bar bigger and more prominent.
- Removed the Instagram link and icon from the footer.
- Added introduction to the main changelog page.
๐Updated credit card collection file
Sample project for basic authorization now links to an updated credit.zip file. The Postman collection and environment files in credit.zip have been updated to reflect changes in several endpoints.
๐Accounts documentation
- The new Address and phone objects guide combines information necessary to create and manage account and phone objects.
- The Address and Phone endpoints have been reorganized and updated and the required fields have been marked appropriately.
๐Account limits report
The Account limits report files now includes the HeldFunds
field.
๐Data and reporting
- Data and reporting overview now includes additional information to better explain data events and timeline events and the differences between them.
- The new Data events guide now lists all the data events guides and keeps them centralized.
- The new Setting up an additional event subscriber guide explains how to share event data from one Org on the Pismo platform with another Org or with an entirely external system that can consume events.
- The new Setting up event filtering guide explains how to filter events (enable or disable sending them) based on the event type or domain.
- The new AWS EventBridge event configuration tutorial explains how to configure EventBridge for streaming event delivery.
๐Pismo Console
- The new Managing processing codes and transaction types guide explains how to work with processing codes and transaction types in the Pismo Console.
- Functionality from the Pismo's legacy Backoffice web application is now available in the Pismo Console via the Backoffice and CRM tabs on the Console main screen.
๐Assets documentation
Assets documentation has been enhanced with the new Assets overview and Asset data events guides.
๐Timeline events
Timeline events overview has been rewritten to be clearer about what timeline events are and how you should implement them.
๐Card issuing
The following new guides are now available:
- Minimum amount due calculation explains how MAD (minimum amount due) is calculated.
- Card network certification explains this requirement for card issuing.
- Cryptographic process with Pismo and the card network.
The โCards overviewโ guide has been renamed to Cards management to more accurately reflect its purpose.
๐Accruals endpoints
Renamed two endpoints in Statements > Accruals:
- "List interest accruals" changed to List account accruals v2.
- "List account accruals" changed to List account accruals v3.
๐Account attributes
In the Manage accounts guide, clarified that the external ID is unique only for the organization.