Upload public key

Upload a public key for validating signatures and sending signed bulk files. For detailed instructions on creating a public key, refer to the Create public and private keys section in <i>File signature and encryption</i>.

To understand how bulk file payment processing works, refer to the Bulk file-based payment processing guide.

post/corporate/v1/bulk-payments/keys

Request

Base URL
https://sandbox.pismolabs.io
URL
https://sandbox.pismolabs.io/corporate/v1/bulk-payments/keys
Auth
HTTP bearer

Request body

idstring required

ID of the public key. Only digits, letters, hyphens, and underscores are allowed, and cannot exceed 60 characters.

key_materialstring required

Public-key encoded in DER and base64 formats

expires_atstring date-time

Expiration date and time of the public key. If not provided, it is set to 6 months from the date of submission.

Example request

{
  "id": "b6cdccc4-f6bf-4218-9e5e-7fb8f66008e3",
  "key_material": "MIIBojANBgkqhkiG9w0BAQEFAAOCAY8AMIIBigKCAYEAsdRPlk9sW4I79X8hDarn82E9/6AZmEpHrG/IAdUkpaHHsQdvELnFySTAWtw5dNPIdBrYyn1jA6+Cf1dKuTjYxqt+TufMVsBbEbRobXHQezu8JajkkCgW9mzVweVP5qVpUFiryH3jHr3sPD8P8nDuKEzVe8Q83mmSt2YKyg95vkHl6iIrbM11whdZS5jy5VzV++P5BLTVvpPbrDFK/OStxStO7JjI0Lhz8zXqIDhopkOHtP9Ai/gFtdKZB3BefYFHTJFNifzyu8CGAZ00wLVfx61eRCi2cFBsW0HngTT+fLoELyvyxfpKmgkV+3eCMr8CkyEIxEpWNCxkOBxGk5LKMUHMka6YfurS0jXKNGi93wKJX3N1h93sPw4QHtRvqTm07zj8S9drSN6qa8B1u6kltWB+FckdOAqDWt2HBme0cy61xWK2REqXUPqywSrN1w2HitCoJOORUjf5zwUyzoGFMHjW9r7eChr8wsidu34DsMQNf6Lu9OzER2kCbhZlRMKZAgMBAAE=",
  "expires_at": "2025-05-21T12:27:00Z"
}

Response

Created

idstring

ID of the public key. Only digits, letters, hyphens, and underscores are allowed, and cannot exceed 60 characters.

Example response

{
  "id": "b6cdccc4-f6bf-4218-9e5e-7fb8f66008e3"
}

Changes

No recorded changes to this operation across all 1 revision of this API.