# Create fee V2
A fee, or *fee collection* in network terminology, allows acquirers and issuers to exchange money outside the standard chargeback process. Typically, this means reversing a settled chargeback, but not always.
You can use this endpoint to create a fee collection/funds disbursement with or without a chargeback **case number**.
You can create a fee collection/funds disbursement for an existing **case**, or, if it doesn't exist, you can provide the necessary transaction/card information to create it.
The main differences between fees V2 and V1 are:
* V1—Associated with the dispute/installment
* V2—Can only be created with transaction ID (Full balance), transaction information (Zero balance), card ID and customer ID, or NetworkCaseID (VisaCaseNumber).
For more information, refer to [Dispute fees](https://developers.pismo.io/pismo-docs/docs/disputes-overview#dispute-fees) in the Disputes overview guide.
This feature is **only** currently available for **Visa**.
# OpenAPI definition
```json
{
"openapi": "3.0.1",
"info": {
"title": "Card issuing - Disputes",
"version": "1.0.0",
"description": "Disputes API endpoints",
"contact": {
"name": "API Support",
"url": "https://developers.pismo.io/support/"
},
"license": {
"name": "Copyright Pismo"
}
},
"servers": [
{
"url": "https://sandbox.pismolabs.io/disputes",
"description": "Sandbox API server for testing"
}
],
"security": [
{
"BearerAuth": []
}
],
"tags": [
{
"name": "Fees V2",
"description": "Endpoints to create and check status for fees V2"
}
],
"components": {
"parameters": {
"Authorization": {
"name": "Authorization",
"in": "header",
"required": true,
"description": "Account token - an access token encoded with a Pismo account ID. Tokens can expire quickly, which can result in a \"** 401 Unauthorized**\" error. \n",
"schema": {
"type": "string"
}
}
},
"schemas": {
"AccountID": {
"type": "number",
"description": "Pismo account ID",
"example": 577830
},
"CardID": {
"type": "number",
"description": "Pismo card ID.",
"example": 123456
},
"TransactionAmount": {
"type": "number",
"description": "Transaction amount",
"example": 86753.09
},
"CreditSender": {
"type": "boolean",
"default": false,
"description": "Credit the sender? Default is `false`."
},
"CreatedAt": {
"type": "string",
"description": "Created at datetime, format = yyyy-mm-dd hh:mm:ss\"",
"example": "2024-10-18 11:21:45"
},
"CustomerId": {
"type": "number",
"example": 10203040,
"description": "Pismo customer ID."
},
"ErrorModel": {
"title": "ErrorModel",
"description": "API generic returned error.",
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Error code."
},
"message": {
"type": "string",
"description": "Error description."
},
"http_status_code": {
"type": "number",
"description": "HTTP status code following RCF-9110"
},
"details": {
"type": "object",
"description": "Payload array returning all fields with problems on request validation.
\nThese validations can be:
\n * Invalid length
\n * Invalid type
\n * Invalid accepted
\n\nValues are explained in the message.
\n"
}
}
},
"OrgId": {
"type": "string",
"description": "Organization/tenant ID.",
"example": "TN-34778262-f4f0-464d-b4c6-a14exxxxxxxx"
},
"TransactionId": {
"type": "number",
"description": "Pismo transaction ID.",
"example": 1234567890
},
"Amount": {
"type": "number",
"format": "double",
"description": "Fee amount.",
"example": 215
},
"Arn": {
"type": "string",
"description": "Acquirer Reference Number (ARN).",
"example": "12345678901234567890123",
"nullable": true
},
"CreditReceiver": {
"type": "boolean",
"description": "Should receiver be credited?"
},
"Currency": {
"type": "string",
"description": "ISO-4217 currency code.",
"example": "USD"
},
"DestinationBIN": {
"type": "string",
"description": "This is the BIN that represents the organization who will receive the Fee Collection/Funds Disbursement.\n\n**REQUIRED** when use `card_id` and `customer_id`\n",
"nullable": true
},
"FeeEventDate": {
"type": "string",
"description": "\nUse this field to pass:\n\n - Date the card was recovered (Reason 150)\n - Collection letter date (Reason 240)\n - Pre-Compliance / Pre-Arbitration Letter Date (Reason 350)\n \n**REQUIRED** when `Reason` is `150`, `240`, or `350` (US domestic); otherwise, it is not valid. \n \nFormat = yyyy-mm-dd\n"
},
"FeeId": {
"type": "number",
"example": 123,
"description": "Pismo fee ID."
},
"FeeMessage": {
"type": "string",
"description": "Fee message. 70 chars maximum.",
"maxLength": 70,
"nullable": true
},
"NetworkBrandType": {
"type": "string",
"description": "Card network brand. Currently, only `Visa`.",
"enum": [
"Visa"
],
"example": "Visa"
},
"NetworkCaseId": {
"type": "string",
"description": "Network case ID.",
"example": "1234567890",
"nullable": true
},
"Source": {
"type": "string",
"description": "Who initiated the fee.",
"enum": [
"ISSUER",
"ACQUIRER"
]
},
"FeeStatus": {
"type": "string",
"description": "Fee status:
\n\n- `PENDING`—The fee creation request has been received and is awaiting Pismo processing within the network.
\n- `FAILED`—An error occurred while attempting to create the fee in the network. The operation was not completed.
\n- `WAITING_NETWORK`—The request has been successfully sent to the network and is currently awaiting a response.
\n- `PROCESSED`—The fee was successfully created and network-confirmed.
\n- `REJECTED`—The network declined the fee creation request.
\n",
"example": "PENDING",
"enum": [
"PENDING",
"FAILED",
"WAITING_NETWORK",
"PROCESSED",
"REJECTED"
]
},
"TransactionDate": {
"type": "string",
"example": "2025-08-11",
"description": "Transaction date, format = yyyy-mm-dd.\n",
"nullable": true
},
"FeeReasonCode": {
"type": "string",
"description": "Fee reason code.
\n `100`—Telecommunication charges (non-US)
\n `110`—Auto telex charges (non-US)
\n `130`—Lost/stolen card report fees
\n `140`—Merchant service fees
\n `150`—Recovered Visa card, Electron card, or Visa Electron card. Handling fees/rewards. Non-US - Recovered card handling fee
\n `170`—Recovery of retrieval request fees.
\n `200`—Emergency replacement card distribution fee
\n `210`—Emergency cash disbursement handling fee
\n `220`—Arbitration/compliance/resolution case decision or filing fee
\n `230`—Incorrect merchant ID/transacton date handling
\n `240`—\"Good faith\" collection letter settlement funds disbursement. Non-US - Funds disbursement transactions
\n `250`—Cardholder does not recognize transacton chargeback handling fee.
\n `350`—Pre-arbitration/Pre-compliance settlement funds disbursement
\n `401`—Prepaid load revenue sharing
\n `402`—Non-US - Collection for an unsettled prepaid of original credit authorization
\n\n**Note:** This is from the Visa IES spreadsheet. This spreadsheet is updated every 6 months or so. Check periodically with Visa for latest fee reason codes.\n",
"enum": [
"100",
"110",
"130",
"140",
"150",
"170",
"200",
"210",
"220",
"230",
"240",
"250",
"350",
"401",
"402"
]
},
"VisaFee": {
"type": "object",
"required": [
"Reason",
"Message"
],
"properties": {
"Reason": {
"$ref": "#/components/schemas/FeeReasonCode"
},
"Message": {
"$ref": "#/components/schemas/FeeMessage"
},
"EventDate": {
"$ref": "#/components/schemas/FeeEventDate"
}
}
},
"VisaFeeCard": {
"type": "object",
"required": [
"Reason",
"Message",
"DestinationBin"
],
"properties": {
"Reason": {
"$ref": "#/components/schemas/FeeReasonCode"
},
"Message": {
"$ref": "#/components/schemas/FeeMessage"
},
"DestinationBin": {
"$ref": "#/components/schemas/DestinationBIN"
},
"EventDate": {
"$ref": "#/components/schemas/FeeEventDate"
}
}
},
"VisaFeeResponse": {
"type": "object",
"properties": {
"Reason": {
"$ref": "#/components/schemas/FeeReasonCode"
},
"Message": {
"$ref": "#/components/schemas/FeeMessage"
},
"EventDate": {
"$ref": "#/components/schemas/FeeEventDate"
}
}
},
"VisaFeeCardResponse": {
"type": "object",
"properties": {
"Reason": {
"$ref": "#/components/schemas/FeeReasonCode"
},
"Message": {
"$ref": "#/components/schemas/FeeMessage"
},
"DestinationBin": {
"$ref": "#/components/schemas/DestinationBIN"
},
"SourceBin": {
"type": "string",
"description": "Bank Identification Number (BIN) of the organization that sends the fee collection/fund's disbursement.\n",
"nullable": true
},
"EventDate": {
"$ref": "#/components/schemas/FeeEventDate"
}
}
},
"Create_Visa_Fee_From_Transaction_Full_Balance": {
"type": "object",
"required": [
"network_brand_type",
"transaction_id",
"currency",
"amount",
"credit_sender",
"credit_receiver",
"fee"
],
"properties": {
"network_brand_type": {
"$ref": "#/components/schemas/NetworkBrandType"
},
"transaction_id": {
"$ref": "#/components/schemas/TransactionId"
},
"currency": {
"$ref": "#/components/schemas/Currency"
},
"amount": {
"$ref": "#/components/schemas/Amount"
},
"credit_sender": {
"$ref": "#/components/schemas/CreditSender"
},
"credit_receiver": {
"$ref": "#/components/schemas/CreditReceiver"
},
"fee": {
"$ref": "#/components/schemas/VisaFee"
}
}
},
"Create_Visa_Fee_From_Transaction_Zero_Balance": {
"type": "object",
"required": [
"network_brand_type",
"arn",
"transaction_amount",
"transaction_date",
"currency",
"amount",
"credit_sender",
"credit_receiver",
"fee"
],
"properties": {
"network_brand_type": {
"$ref": "#/components/schemas/NetworkBrandType"
},
"arn": {
"$ref": "#/components/schemas/Arn"
},
"transaction_amount": {
"$ref": "#/components/schemas/TransactionAmount"
},
"transaction_date": {
"$ref": "#/components/schemas/TransactionDate"
},
"currency": {
"$ref": "#/components/schemas/Currency"
},
"amount": {
"$ref": "#/components/schemas/Amount"
},
"credit_sender": {
"$ref": "#/components/schemas/CreditSender"
},
"credit_receiver": {
"$ref": "#/components/schemas/CreditReceiver"
},
"fee": {
"$ref": "#/components/schemas/VisaFee"
}
}
},
"Create_Visa_Fee_From_Card": {
"type": "object",
"required": [
"network_brand_type",
"card_id",
"customer_id",
"currency",
"amount",
"credit_sender",
"credit_receiver",
"fee"
],
"properties": {
"network_brand_type": {
"$ref": "#/components/schemas/NetworkBrandType"
},
"card_id": {
"$ref": "#/components/schemas/CardID"
},
"customer_id": {
"$ref": "#/components/schemas/CustomerId"
},
"currency": {
"$ref": "#/components/schemas/Currency"
},
"amount": {
"$ref": "#/components/schemas/Amount"
},
"credit_sender": {
"$ref": "#/components/schemas/CreditSender"
},
"credit_receiver": {
"$ref": "#/components/schemas/CreditReceiver"
},
"fee": {
"$ref": "#/components/schemas/VisaFeeCard"
}
}
},
"Create_Visa_Fee_From_Network_Case_ID": {
"type": "object",
"required": [
"network_brand_type",
"network_case_id",
"currency",
"amount",
"credit_sender",
"credit_receiver",
"fee"
],
"properties": {
"network_brand_type": {
"$ref": "#/components/schemas/NetworkBrandType"
},
"network_case_id": {
"$ref": "#/components/schemas/NetworkCaseId"
},
"currency": {
"$ref": "#/components/schemas/Currency"
},
"amount": {
"$ref": "#/components/schemas/Amount"
},
"credit_sender": {
"$ref": "#/components/schemas/CreditSender"
},
"credit_receiver": {
"$ref": "#/components/schemas/CreditReceiver"
},
"fee": {
"$ref": "#/components/schemas/VisaFee"
}
}
},
"Fee_Response_From_Transaction_Full_Balance": {
"type": "object",
"properties": {
"fee_id": {
"$ref": "#/components/schemas/FeeId"
},
"org_id": {
"$ref": "#/components/schemas/OrgId"
},
"account_id": {
"$ref": "#/components/schemas/AccountID"
},
"network_brand_type": {
"$ref": "#/components/schemas/NetworkBrandType"
},
"transaction_id": {
"$ref": "#/components/schemas/TransactionId"
},
"arn": {
"$ref": "#/components/schemas/Arn"
},
"transaction_amount": {
"$ref": "#/components/schemas/TransactionAmount"
},
"transaction_date": {
"$ref": "#/components/schemas/TransactionDate"
},
"currency": {
"$ref": "#/components/schemas/Currency"
},
"amount": {
"$ref": "#/components/schemas/Amount"
},
"credit_sender": {
"$ref": "#/components/schemas/CreditSender"
},
"credit_receiver": {
"$ref": "#/components/schemas/CreditReceiver"
},
"fee": {
"$ref": "#/components/schemas/VisaFeeResponse"
},
"created_at": {
"$ref": "#/components/schemas/CreatedAt"
},
"source": {
"$ref": "#/components/schemas/Source"
},
"status": {
"$ref": "#/components/schemas/FeeStatus"
}
}
},
"Fee_Response_From_Transaction_Zero_Balance": {
"type": "object",
"properties": {
"fee_id": {
"$ref": "#/components/schemas/FeeId"
},
"org_id": {
"$ref": "#/components/schemas/OrgId"
},
"account_id": {
"$ref": "#/components/schemas/AccountID"
},
"network_brand_type": {
"$ref": "#/components/schemas/NetworkBrandType"
},
"arn": {
"$ref": "#/components/schemas/Arn"
},
"transaction_amount": {
"$ref": "#/components/schemas/TransactionAmount"
},
"transaction_date": {
"$ref": "#/components/schemas/TransactionDate"
},
"currency": {
"$ref": "#/components/schemas/Currency"
},
"amount": {
"$ref": "#/components/schemas/Amount"
},
"credit_sender": {
"$ref": "#/components/schemas/CreditSender"
},
"credit_receiver": {
"$ref": "#/components/schemas/CreditReceiver"
},
"fee": {
"$ref": "#/components/schemas/VisaFeeResponse"
},
"created_at": {
"$ref": "#/components/schemas/CreatedAt"
},
"source": {
"$ref": "#/components/schemas/Source"
},
"status": {
"$ref": "#/components/schemas/FeeStatus"
}
}
},
"Fee_Response_From_Card": {
"type": "object",
"properties": {
"fee_id": {
"$ref": "#/components/schemas/FeeId"
},
"org_id": {
"$ref": "#/components/schemas/OrgId"
},
"account_id": {
"$ref": "#/components/schemas/AccountID"
},
"network_brand_type": {
"$ref": "#/components/schemas/NetworkBrandType"
},
"currency": {
"$ref": "#/components/schemas/Currency"
},
"amount": {
"$ref": "#/components/schemas/Amount"
},
"credit_sender": {
"$ref": "#/components/schemas/CreditSender"
},
"credit_receiver": {
"$ref": "#/components/schemas/CreditReceiver"
},
"card_id": {
"$ref": "#/components/schemas/CardID"
},
"fee": {
"$ref": "#/components/schemas/VisaFeeCardResponse"
},
"created_at": {
"$ref": "#/components/schemas/CreatedAt"
},
"source": {
"$ref": "#/components/schemas/Source"
},
"status": {
"$ref": "#/components/schemas/FeeStatus"
}
}
},
"Fee_Response_From_Network_Case_ID": {
"type": "object",
"properties": {
"fee_id": {
"$ref": "#/components/schemas/FeeId"
},
"org_id": {
"$ref": "#/components/schemas/OrgId"
},
"account_id": {
"$ref": "#/components/schemas/AccountID"
},
"network_brand_type": {
"$ref": "#/components/schemas/NetworkBrandType"
},
"currency": {
"$ref": "#/components/schemas/Currency"
},
"amount": {
"$ref": "#/components/schemas/Amount"
},
"credit_sender": {
"$ref": "#/components/schemas/CreditSender"
},
"credit_receiver": {
"$ref": "#/components/schemas/CreditReceiver"
},
"network_case_id": {
"$ref": "#/components/schemas/NetworkCaseId"
},
"fee": {
"$ref": "#/components/schemas/VisaFeeResponse"
},
"created_at": {
"$ref": "#/components/schemas/CreatedAt"
},
"source": {
"$ref": "#/components/schemas/Source"
},
"status": {
"$ref": "#/components/schemas/FeeStatus"
}
}
}
},
"securitySchemes": {
"BearerAuth": {
"type": "http",
"scheme": "bearer",
"description": "Account access token. Tokens can expire quickly, which can result in an \"Unauthorized\" error.",
"bearerFormat": "JWT"
}
}
},
"paths": {
"/v2/fee": {
"post": {
"summary": "Create fee V2",
"description": "A fee, or *fee collection* in network terminology, allows acquirers and issuers to exchange money outside the standard chargeback process. Typically, this means reversing a settled chargeback, but not always.\n\nYou can use this endpoint to create a fee collection/funds disbursement with or without a chargeback **case number**.\n\nYou can create a fee collection/funds disbursement for an existing **case**, or, if it doesn't exist, you can provide the necessary transaction/card information to create it.\n\nThe main differences between fees V2 and V1 are:\n * V1—Associated with the dispute/installment\n * V2—Can only be created with transaction ID (Full balance), transaction information (Zero balance), card ID and customer ID, or NetworkCaseID (VisaCaseNumber).\n\nFor more information, refer to [Dispute fees](https://developers.pismo.io/pismo-docs/docs/disputes-overview#dispute-fees) in the Disputes overview guide. \n\nThis feature is **only** currently available for **Visa**.\n",
"operationId": "create-fee-v2",
"tags": [
"Fees V2"
],
"parameters": [
{
"$ref": "#/components/parameters/Authorization"
}
],
"requestBody": {
"required": true,
"description": "Fill out and submit one object",
"content": {
"application/json": {
"schema": {
"anyOf": [
{
"$ref": "#/components/schemas/Create_Visa_Fee_From_Transaction_Full_Balance"
},
{
"$ref": "#/components/schemas/Create_Visa_Fee_From_Transaction_Zero_Balance"
},
{
"$ref": "#/components/schemas/Create_Visa_Fee_From_Card"
},
{
"$ref": "#/components/schemas/Create_Visa_Fee_From_Network_Case_ID"
}
]
},
"examples": {
"FeeVisaFromTransactionFullBalance": {
"summary": "Create Visa Fee from Transaction - Full Balance",
"value": {
"network_brand_type": "Visa",
"transaction_id": 1234567890,
"currency": "USD",
"amount": 150,
"credit_sender": false,
"credit_receiver": true,
"fee": {
"Reason": "350",
"Message": "Fee collection created via SYSTEM",
"DestinationBin": "474749",
"EventDate": "2025-08-28"
}
}
},
"FeeFromTransactionZeroBalance": {
"summary": "Create Visa Fee from Transaction - Zero Balance",
"value": {
"network_brand_type": "Visa",
"arn": "0000000000539598",
"transaction_date": "2022-09-02",
"transaction_amount": 150,
"currency": "USD",
"amount": 150,
"credit_sender": false,
"credit_receiver": true,
"fee": {
"Reason": "100",
"Message": "Fee collection created via SYSTEM",
"DestinationBin": "484884"
}
}
},
"FeeFromCard": {
"summary": "Create Visa Fee from Card",
"value": {
"network_brand_type": "Visa",
"currency": "USD",
"amount": 150,
"credit_sender": true,
"credit_receiver": false,
"card_id": 123456,
"customer_id": 7890123,
"fee": {
"Reason": "130",
"Message": "Fee collection created via SYSTEM",
"DestinationBin": "484884"
}
}
},
"FeeFromNetworkCaseID": {
"summary": "Create Visa Fee from Network Case ID",
"value": {
"network_brand_type": "Visa",
"network_case_id": "10203040",
"currency": "USD",
"amount": 150,
"credit_sender": true,
"credit_receiver": false,
"fee": {
"Reason": "350",
"Message": "Fee collection created via SYSTEM",
"EventDate": "2025-08-28"
}
}
}
}
}
}
},
"responses": {
"201": {
"description": "Created",
"content": {
"application/json": {
"schema": {
"anyOf": [
{
"$ref": "#/components/schemas/Fee_Response_From_Transaction_Full_Balance"
},
{
"$ref": "#/components/schemas/Fee_Response_From_Transaction_Zero_Balance"
},
{
"$ref": "#/components/schemas/Fee_Response_From_Card"
},
{
"$ref": "#/components/schemas/Fee_Response_From_Network_Case_ID"
}
]
},
"examples": {
"FeeResponseFromTransactionFullBalance": {
"summary": "Visa Fee from Transaction - Full Balance",
"value": {
"fee_id": 1,
"org_id": "TN-123",
"account_id": 102030,
"network_brand_type": "Visa",
"transaction_id": 1234567890,
"arn": "ABC123YZ25",
"transaction_amount": 150,
"transaction_date": "2024-09-27",
"currency": "USD",
"amount": 150,
"credit_sender": false,
"credit_receiver": true,
"fee": {
"event_date": "2025-08-28",
"message": "Fee collection created via SYSTEM",
"reason": "350"
},
"created_at": "2025-08-29 18:05:08",
"status": "PENDING",
"source": "ISSUER"
}
},
"FeeResponseFromTransactionZeroBalance": {
"summary": "Visa Fee from Transaction - Zero Balance",
"value": {
"fee_id": 1,
"org_id": "TN-123",
"account_id": 102030,
"network_brand_type": "Visa",
"arn": "0000000000539598",
"transaction_amount": 150,
"transaction_date": "2022-09-02",
"currency": "USD",
"amount": 150,
"credit_sender": false,
"credit_receiver": true,
"fee": {
"message": "Fee collection created via SYSTEM",
"reason": "100"
},
"created_at": "2025-08-29 18:05:29",
"status": "PENDING",
"source": "ISSUER"
}
},
"FeeResponseFromCard": {
"summary": "Visa Fee from Card",
"value": {
"fee_id": 1,
"org_id": "TN-123",
"account_id": 102030,
"network_brand_type": "Visa",
"currency": "USD",
"amount": 150,
"credit_sender": true,
"credit_receiver": false,
"fee": {
"destination_bin": "234324",
"message": "Fee collection created via SYSTEM",
"reason": "130",
"source_bin": "123456"
},
"created_at": "2025-08-29 18:05:43",
"card_id": 405060,
"status": "PENDING",
"source": "ISSUER"
}
},
"FeeResponseFromNetworkCaseId": {
"summary": "Visa Fee from Network Case ID",
"value": {
"fee_id": 1,
"org_id": "TN-123",
"account_id": 102030,
"network_brand_type": "Visa",
"network_case_id": "1234",
"currency": "USD",
"amount": 150,
"credit_sender": false,
"credit_receiver": true,
"fee": {
"event_date": "2025-08-28",
"message": "Fee collection created via SYSTEM",
"reason": "350"
},
"created_at": "2025-08-29 18:05:57",
"status": "PENDING",
"source": "ISSUER"
}
}
}
}
}
},
"400": {
"description": "Bad request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorModel"
},
"examples": {
"EDPT0002 - Failed during validation of request payload": {
"value": {
"code": "EDPT0003",
"message": "Failed to parse request payload",
"http_status_code": 400
}
},
"BDPT0019 - Unsupported Fee brand type": {
"value": {
"code": "BDPT0019",
"message": "Unsupported Fee brand type",
"http_status_code": 400
}
}
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorModel"
},
"examples": {
"EDPT0005 - Missing or invalid Authorization header": {
"value": {
"code": "EDPT0005",
"message": "Missing or invalid Authorization header",
"http_status_code": 401
}
}
}
}
}
},
"404": {
"description": "Not found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorModel"
},
"examples": {
"EDPT0009 - TransactionById returned not found": {
"value": {
"code": "EDPT0009",
"message": "TransactionById returned [Not found] using ID: 1234567890",
"http_status_code": 404
}
},
"EDPT0009 - Cards returned not found": {
"value": {
"code": "EDPT0009",
"message": "Cards returned [Not found] using ID: 405060",
"http_status_code": 404
}
}
}
}
}
},
"422": {
"description": "Unprocessable entity",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorModel"
},
"examples": {
"BDPT0001 - Error while validating fields": {
"value": {
"code": "BDPT0001",
"message": "Error while validating fields",
"http_status_code": 422,
"details": {
"payload": [
{
"field": "network_brand_type",
"message": "This is field is required"
},
{
"field": "currency",
"message": "This is field is required"
},
{
"field": "amount",
"message": "This is field is required"
},
{
"field": "credit_sender",
"message": "This is field is required"
},
{
"field": "credit_sender",
"message": "This field cannot have the same value as the: 'credit_receiver'"
},
{
"field": "credit_receiver",
"message": "This is field is required"
},
{
"field": "credit_receiver",
"message": "This field cannot have the same value as the: 'credit_sender'"
},
{
"field": "fee",
"message": "This is field is required"
},
{
"field": "currency",
"message": "This field does not comply with the ISO 4217 standard"
},
{
"field": "transaction_date",
"message": "This field has an invalid date format. The correct format is yyyy-MM-dd"
},
{
"field": "reason",
"message": "This field has an invalid value. The accepted values are: 100, 110, 130, 140, 150, 170, 200, 210, 220, 230, 240, 250, 350, 401, 402"
},
{
"field": "transaction_id",
"message": "This field is required when the other fields are not filled: 'network_case_id', 'destination_bin', 'arn', 'transaction_amount', 'transaction_date'"
},
{
"field": "arn",
"message": "This field is required when the other fields are not filled: 'transaction_id', 'network_case_id', 'destination_bin'"
},
{
"field": "transaction_amount",
"message": "This field is required when the other fields are not filled: 'transaction_id', 'network_case_id', 'destination_bin'"
},
{
"field": "transaction_date",
"message": "This field is required when the other fields are not filled: 'transaction_id', 'network_case_id', 'destination_bin'"
},
{
"field": "network_case_id",
"message": "This field is required when the other fields are not filled: 'transaction_id', 'destination_bin', 'arn', 'transaction_amount', 'transaction_date'"
},
{
"field": "destination_bin",
"message": "This field is required when the other fields are not filled: 'transaction_id', 'network_case_id', 'arn', 'transaction_amount', 'transaction_date'"
},
{
"field": "card_id",
"message": "This field is required when 'destination_bin' is filled in"
}
]
}
}
},
"BDPT0021 - Authorized Account is different from request": {
"value": {
"code": "BDPT0021",
"message": "Authorized Account is different from request",
"http_status_code": 422
}
},
"BDPT0022 - Network Brand Type Mismatch": {
"value": {
"code": "BDPT0022",
"message": "The 'network_brand_type' [Visa] of the request does not match the 'network' [Mastercard] associated with the Transaction",
"http_status_code": 422
}
}
}
}
}
},
"500": {
"description": "Internal server error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorModel"
},
"examples": {
"EDPT9998 - Something went wrong, please try again later": {
"value": {
"code": "EDPT9998",
"message": "Something went wrong, please try again later",
"http_status_code": 500
}
}
}
}
}
},
"504": {
"description": "Gateway timeout",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorModel"
},
"examples": {
"EDPT0001 - Request timeout": {
"value": {
"code": "EDPT0001",
"message": "Request timeout",
"http_status_code": 504
}
}
}
}
}
}
}
}
}
}
}
```