Sign in

v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB
Authorizations

Simulate authorization

You can use this endpoint to simulate a real-world authorization from the network in the sandbox environment. This simulation does not go through all the card network services as it would in production, but it does check for card status and balance. The call gives you a chance to see how Pismo might respond to a network authorization. The fields returned can be used to cancel or confirm the request with this endpoint.

You can also use this endpoint to cancel (total or partial) the simulated authorization in the EXT/HOMOLOG environment. To cancel in the production environments, use the Cancel authorization endpoint.

This endpoint generates the simulated Network authorization received event which you can receive and view. This event occurs in production when the Pismo platform cancels or confirms an authorization. You can also use this endpoint to test connectivity to your anti-fraud webhook url.

For more information, see the Simulate authorizations guide.

post/networktransactions/v1/authorizations

Headers

x-tenantstring required

Pismo organization/tenant ID

Request body

OR
OR
OR
OR
OR
OR

Example request

{
  "card_id": 4926027,
  "mti": "0100",
  "local_amount": 100.5,
  "local_currency": "986",
  "entry_mode": "901",
  "merchant": {
    "name": "merchantName"
  }
}

Response

Resource founded

mtistring

Message type ID. For example: 0100 = auth. request, 0110`` = auth. response, 0120` = auth. advice. For more information, see MTI.

authorization_codestring

Authorization code.

response_codestring

Network two-digit response code. For example: 00 = approve, 51 = insufficient funds, 57 = card not active, 96 = system failure, etc. For more information, see Validation codes for authorization events. If approve = false, you can use this value to respond to the network.

authorization_date_timestring

Authorization date and time in Coordinated Universal Time (UTC), i.e., 2020-01-01T10:10:00.000-03:00.

custom_code'FL2' | 'FL8' | 'FLB' | 'FLE' | 'DCM' | 'VMN' | '998' | 'LUD' | 'LUE' | 'LUT' | 'LGE' | '810' | 'PFT' | 'IAT' | 'BND' | 'ANF' | 'CTE' | 'CED' | 'ZBD' | 'FRB' | 'UBT' | 'FL6' | 'BNF' | 'BNP' | 'BNR' | 'VED' | 'BNU' | 'VEV' | 'UBN' | 'CSU' | 'NPL' | 'OP1' | 'TNF' | 'Z26' | 'Z24' | 'Z29' | 'Z23' | 'Z22'

Internal custom code generated in authorization flow for declined requests, indicating the reason the request was declined.

For more information, see authorization validations.

match_addressboolean

Is cardholder address street and number the same as that contained on the platform?

match_postal_codeboolean

Is cardholder postal code the same as the one contained on the platform?

postal_five_digitsboolean

Is this a valid postal code with five digits?

no_address_databoolean

Is address registered on platform?

authorization_idinteger

Authorization ID

account_idinteger

Account ID

installment_valuestring

Installment value. If there are no installments, this is the same as contract_amount.

interest_ratenumber

Monthly interest rate

number_of_installmentsnumber

Number of installments

contract_amountstring

Transaction value

Example response

{
  "mti": "0100",
  "authorization_code": "F0JR9H",
  "response_code": "00",
  "authorization_date_time": "2020-01-01T10:10:00.000-03:00",
  "custom_code": "FLB",
  "match_address": true,
  "match_postal_code": true,
  "postal_five_digits": true,
  "no_address_data": true,
  "authorization_id": 4923745,
  "account_id": 24141240,
  "installment_value": "100.00",
  "interest_rate": 2,
  "number_of_installments": 2,
  "contract_amount": "100.00",
  "crediario_responses": [
    {
      "installmentValue": "51.86",
      "monthlyInterestRate": "2.00",
      "totalAmount": "103.72",
      "numberOfInstallments": "2",
      "feeAmount": "0.00",
      "taxesAmount": "0.86",
      "taxesPercentageOfTotalAmount": "0.83",
      "feePercentageOfTotalAmount": "0.00",
      "planType": "",
      "annualInterestRate": "",
      "monthlyTotalEffectiveCost": "",
      "annualTotalEffectiveCost": "",
      "installmentDate": "",
      "insurance": "",
      "insurancePercentageOfTotalAmount": "",
      "other": "",
      "otherPercentageOfTotalAmount": "",
      "totalAmountToMerchant": "",
      "merchantAmountPercentage": "",
      "reservedForFutureUse": ""
    }
  ]
}