v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB

Payment method configurations

Create program configuration

Create a payment methods configuration at the program level. This level can be used as a default configuration for all accounts in this program and at a more granular level than org. There can be only one program configuration. New creation attempts for the same program receive a conflict response.

Note: This is a PCI endpoint, use the https://gw-pci.pismolabs.io environment.

post/payment-methods-configs/v1/configs/programs/{programId}

Request body

Example request

{
  "authorization": {
    "networks": [
      {
        "identifier": "Mastercard",
        "hsm_keys_id": "123456"
      }
    ],
    "cancellation_threshold": 1440,
    "confirmation_verification_endpoint": "https://yourverificationendpoint.com",
    "confirmation_verification_mtls": true,
    "confirmation_verification_mtls_prefix": "url-prefix",
    "confirmation_verification_rate": 30,
    "allow_authorization_by_document_number": true,
    "require_external_authentication": true,
    "update_balance_after_discharge": true
  },
  "payment": {
    "require_external_authentication": true,
    "update_balance_after_discharge": true
  },
  "transfer": {
    "from": {
      "require_external_authentication": true
    },
    "to": {
      "require_external_authentication": true
    }
  }
}

Response

Created

Example response

{
  "authorization": {
    "networks": [
      {
        "identifier": "Mastercard",
        "hsm_keys_id": "123456"
      }
    ],
    "cancellation_threshold": 1440,
    "confirmation_verification_endpoint": "https://yourverificationendpoint.com",
    "confirmation_verification_mtls": true,
    "confirmation_verification_mtls_prefix": "url-prefix",
    "confirmation_verification_rate": 30,
    "allow_authorization_by_document_number": true,
    "require_external_authentication": true,
    "update_balance_after_discharge": true
  },
  "payment": {
    "require_external_authentication": true,
    "update_balance_after_discharge": true
  },
  "transfer": {
    "from": {
      "require_external_authentication": true
    },
    "to": {
      "require_external_authentication": true
    }
  }
}