7 February 2025
Changes between 3 January and 7 February 2025
Accounting
Updated
The new Get account buckets endpoint is now available.
Accounts
Docs
In the Transfer account to different program endpoint, introduction was updated to clarify that the account keeps the flex controls of the original program.
Docs
In the Account status guide, instructions about rolling back an account status were streamlined.
Docs
The date format of the birth_date
field was corrected in the following endpoints.
Docs
The Accounts API reference documentation was updated for standards such as updated event names.
Docs
In the Create account application endpoint, the descriptions for account
, personal
, and company
were updated to correctly represent the entity’s external ID.
Client webhooks
Updated
The following changes were made in the anti-fraud payload for full balance clients only.
- The two new required request fields
card_mode_type
andpin_validated
were added. - The options list for request field
card_status
was updated to include more options. - The new optional response field
merchant_denial_code
was added.
The new request and response fields are defined in the Client webhooks guide.
Flexible transaction controls
Docs
In the Update customer flex control endpoint, documentation was updated to note that the current_spend_limit
field is internal.
Docs
The Flexible transaction controls guide was updated for clarity.
Migrations
New
The new Migrate accounts (v2) endpoint is now available. It relocates the address and phone fields to outside the applicant.personal object. The Migrate accounts (v1) endpoint remains available to support existing implementations.
New
The new Fee model migration endpoint is now available. This endpoint generates two new events: Fee model account migration started and Fee Model account migration completed.
Updated
The Authorization migration completed event was updated to include a number of missing fields.
Updated
The Migrate transaction endpoint was updated to add the field instant_payment_data.internal_transaction
. This is a boolean that, if true, means the credit and debit transactions for an instant payment both happened within the same organization.
Payments
Updated
In the Block amount endpoint, the new skip_status_account_validation
field is now available.
Updated
In the Create pre-schedule [beta] endpoint, the error 409 was replaced with error 200.
Docs
In the Create installments payment endpoint, the pattern for first_installment_date
was added to the field’s description.
Security
Docs
The Generate your JSON Web Token (JWT) section of the Authentication with OpenID guide was updated to indicate where users can find the list of valid groups. A reference and link to the View API permission groups was also added for clarification.
Docs
The Identity connectivity with mTLS guide was updated to include a list of details that need to be provided to Pismo before mTLS can be issued.
Docs
Due to Postman warning issues, token examples were removed from the Get OpenID access token endpoint documentation.
Setup
Docs
The new Program types guide is now available.
Docs
In the Programs API reference documentation, the explanation of due_dates
was improved to explain that this is an array defined in the program configuration. The accounts in the program specify the ID of which available due date to use.
Docs
The Holidays API reference documentation was rewritten and updated for clarity. The following endpoints were renamed to better reflect their functionality.
- Validate holiday > Get holiday
- Search for business day > Check if business day
- Update holiday > Update holiday name
Support
The Pismo operations status guide was updated. Customers now must request access to the Operations Status page from their Pismo representative.
Transactions
New
To meet ISO 4217 standards, every instance of the currency
field description was updated and new currency
field was added to the tax
object in the Transactions API.
Docs
The Create transaction type endpoint documentation now links to Standard processing codes.
Events
Docs
In the Account balance changed event, the fields currency_code
and currency_numeric_code
were added.
Docs
The Interest plan creation succeeded event is now Interest plan created.
Docs
The Transaction created event and the links in Core platform - Transactions were standardized.
Banking as a Service
Docs
A legal disclaimer was added to both the Banking as a Service (BaaS) section in the Banking overview and the Banking as a Service guide. This disclaimer clarifies that Pismo only provides the technology and collaborates with partners to provide BaaS services to customers.
Instant payments
New
The following new endpoints are now available in the Pix payments API.
- Cancel Pix-out scheduled execution
- Get transaction from provider can be used to verify that both provider and Pismo have the same information.
Transaction banking
Updated
In the Update dormancy configuration endpoint, the path parameter externalAccountId
was changed to dormancyConfigId
.
Updated
In the Post payment endpoint, the following changes were made.
- New 400 error codes were added:
WPMT0044: Back business dating is disabled.
This error occurs when the back business payment feature is disabled through the Past business date toggle endpoint.WPMT0051: Operation not allowed by reason: <reason>.
This error indicates the post payment is not allowed by the status reason provided.
- The status reasons for
force_post
in the request and response payloads were updated. Previously, the status reasons in the request and response bodies were:CREDIT ONLY
— No force debit allowedDEBIT ONLY
— No force credit allowedANY
— No force allowedMANUAL
— No force allowed
- The new status reasons are:
ALL_NO_FORCE_ALLOWED
DEBIT_ONLY_NO_FORCE_CREDIT_ALLOWED
CREDIT_ONLY_NO_FORCE_DEBIT_ALLOWED
FORCE_DEBIT_ONLY
FORCE_CREDIT_ONLY
NONE_NO_FORCE_ALLOWED
Updated
In the Post multi-leg payment endpoint, the following changes were made.
- New 400 errors were added:
WMLP0005: Validation error: one or more legs did not pass validation.
This error is related to back business dating.WMLP1037: Debit not allowed by reason - <reason>.
This error occurs when the debit transaction is not allowed by the status reason clients provided.WMLP1038: Credit not allowed by reason - <reason>.
This error occurs when the credit transaction is not allowed by the status reason clients provided.
- The status reasons for force_post for the debit object in the request and response payloads were updated. Previously, the status reasons in the request and response bodies were:
CREDIT ONLY
— No force debit allowedDEBIT ONLY
— No force credit allowedANY
— No force allowedMANUAL
— No force allowed
- The new status reasons are:
ALL_NO_FORCE_ALLOWED
CREDIT_ONLY_NO_FORCE_DEBIT_ALLOWED
FORCE_CREDIT_ONLY
NONE_NO_FORCE_ALLOWED
- For
force_post
in thecredit
object, the status reasons used to be:CREDIT ONLY
— No force debit allowedDEBIT ONLY
— No force credit allowedANY
— No force allowedMANUAL
— No force allowed
- Now they are:
ALL_NO_FORCE_ALLOWED
DEBIT_ONLY_NO_FORCE_CREDIT_ALLOWED
FORCE_DEBIT_ONLY
NONE_NO_FORCE_ALLOWED
Docs
The following guides are now available.
Docs
The Bulk file-based payment processing guide now includes a table of common error messages output by the response file.
Authorization
Updated
The Authorization configurations API was updated to include DELETE endpoints.
Docs
Two new guides are available for working with the Authorization configurations API. The new guide Authorization configurations gives details on the required parameters for Full balance and Zero balance. The new guide Run the configuration requests provides sample code and examples of how to use the various API requests.
Docs
Field descriptions in the Authorization API reference documentation were updated for clarity and completeness and to include default values for all boolean fields.
Docs
The Simulate authorization endpoint was updated to properly indicate all required parameter fields.
Docs
The API reference guide for Card issuing - Authorizations (network-transactions-api) was updated to include default values for all Boolean fields and to include revised descriptions for clarity.
Card network integration
Updated
The custom authorization validation code for UBN
(NFC disabled) was changed from 57
to 78
for Visa and from FM
to 78
for ELO. This change, and all validation codes, can be found in the Validation codes for authorization events guide.
Docs
The Simulate authorizations guide was updated to include a note for considerations when using processing codes.
Docs
Definitions for custom validation codes BII
(Balance inquiry internal error), IZA
(Zero amount not allowed), and ZBD
(Zero balance client declined) were added to the Validation codes definitions guide.
Docs
Custom validation codes for ELO were added to all validation tables in the Rule list guide. In addition, corrections were made to the following codes in the Rule list guide to ensure accuracy: 988
(Visa), BNW
(Visa), FRE
(RuPay), FRN
(Visa), LAE
(Visa), OP1
(Visa), PCE
(Visa), TSM
(TecBan), and UBT
(Visa and Mastercard).
Docs
The authorization validation rules Account number inquiry (ANI
) and Address verification service (AVS
) were added to the Authorization validation rules for card network operations guide and to the Rule list guide.
Embossing
New
Customers who work with ondemand embossing can now emboss cards with NORMAL, BLOCKED, PENDING, WARNING status, in addition to CREATED.
Network transactions
Docs
The description for the cvv_present
field in the Network authorization received event was updated for clarification to specify that the field is looking at the CVV2 code. This change clarifies that the boolean flag only considers CVV2 validation. To validate the presence of CVV1 using this endpoint, consider using the track1_present
and track2_present
attributes.
Statements
Docs
The following new guides are now available.
- Calendars and holidays in credit card accounts
- Create an installment agreement
- Configuring a sellos tax explains the sellos tax. While the sellos tax itself is not a new feature, the capability of setting a minimum amount for it is new. How to do this is explained in the guide.
Docs
The description of the Save program due date endpoint was updated to clarify its behavior.
Docs
Made various changes to the Statements API to bring it up to Pismo standards, such as specifying the default values for parameters and clarifying parameter descriptions. Updated some endpoint descriptions. Moved endpoints dealing with transaction categories into their own section called “Transaction categories”. Similarly, moved endpoints for transaction types into “Transaction types”.
Docs
In the Create a statement agreement guide, items 6 and 7 were added to the numbered bullet point list.
Docs
In the Update interest accrual statuses endpoint, SETTLED
was added to the list of possible values for the new_status
field, which is a property of the objects in the accruals array in the body of the request.
Docs
A diagram was added to the Calendars and holidays in credit card accounts guide and the paragraph above the diagram was updated to refer to it.
Docs
In the Minimum amount due calculation guide, corrected Over-limit amount
in Strategy 2 examples > Second example > Cycle 3 statement. It used to be $322.50. The correct value is $304.50.
Pismo Control Center
Docs
In Control Center, the program creation flow was redesigned to provide better user experience.
Updated
Notification emails from Pismo now come from the domains @notify.pismo.io and @notify.pismolabs.io. Please take any necessary steps to ensure proper email receipt.