--- agentTools: projectIndex: https://mk-bank.readme.io/llms.txt --- # Perform manual payment The Perform Manual Payment endpoint allows you to perform a manual payment transaction by providing the necessary details of the recipient. This method is useful when making payments to recipients who are not associated with a specific Pix key. You need to provide the payment amount, additional notes, and recipient information such as name, document number, bank ISPB number, account number, account branch, and account type. # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "MK Bank Account API", "version": "1.0" }, "servers": [ { "url": "https://core-h.mkbank.com.br/api" } ], "components": { "securitySchemes": { "sec0": { "type": "apiKey", "in": "header", "name": "Authorization", "x-bearer-format": "bearer" } } }, "security": [ { "sec0": [] } ], "paths": { "/pix/perform_manual_payment": { "post": { "summary": "Perform manual payment", "description": "The Perform Manual Payment endpoint allows you to perform a manual payment transaction by providing the necessary details of the recipient. This method is useful when making payments to recipients who are not associated with a specific Pix key. You need to provide the payment amount, additional notes, and recipient information such as name, document number, bank ISPB number, account number, account branch, and account type.", "operationId": "perform-manual-payment", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "amount", "recipient" ], "properties": { "amount": { "type": "number", "description": "Payement amount. Min: 0.01", "format": "double" }, "notes": { "type": "string", "description": "Some notes." }, "correlation_id": { "type": "string" }, "recipient": { "type": "object", "required": [ "name", "document_number", "bank_ispb", "account_number", "account_branch", "account_type" ], "properties": { "name": { "type": "string", "description": "Recipient name." }, "document_number": { "type": "string", "description": "Recipient CPF or CNPJ." }, "bank_ispb": { "type": "string", "description": "Recipient bank ISPB number." }, "account_number": { "type": "string", "description": "Recipient account number." }, "account_branch": { "type": "string", "description": "Recipient account branch. Length: 4 characters.", "default": "0001" }, "account_type": { "type": "string", "description": "Recipient account type. Can be CACC, TRAN, SLRY or SVGS.", "default": "CACC", "enum": [ "CACC", "TRAN", "SLRY", "SVGS" ] } } } } } } } }, "responses": { "201": { "description": "201", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"authentication_code\": \"9e2bd77c-300b-4b74-bca3-12fb0e8cea9d\",\n \"account_id\": 1060,\n \"type\": \"CASH_OUT\",\n \"amount\": -8,\n \"description\": \"Pagamento PIX\",\n \"complement\": \"João teste\",\n \"scheduling_date\": \"2023-07-20\",\n \"performed_at\": null,\n \"performed_at_timestamp\": null,\n \"status\": \"CREATED\",\n \"initiator\": \"API\",\n \"owner_id\": 83151,\n \"owner_type\": \"App\\\\Models\\\\PixPayment\",\n \"updated_at\": \"2023-07-20T18:59:29.000000Z\",\n \"created_at\": \"2023-07-20T18:59:29.000000Z\",\n \"id\": 99005,\n \"owner\": {\n \"id\": 83151,\n \"authentication_code\": \"d5d32688-8af4-4930-b663-1b54a7b088ff\",\n \"end_to_end_id\": \"E35624319202307201859F4ZdX8BeDg0\",\n \"account_id\": 1060,\n \"amount\": 8,\n \"notes\": \"Teste QA\",\n \"scheduling_date\": \"2023-07-20T18:59:29.000000Z\",\n \"performed_at\": null,\n \"performed_at_timestamp\": null,\n \"status\": \"CREATED\",\n \"reason\": null,\n \"sender_account_bank_code\": null,\n \"sender_account_bank_ispb\": \"35624319\",\n \"sender_account_bank_name\": \"MK Digital Bank S.A.\",\n \"sender_account_branch\": \"3000\",\n \"sender_account_number\": \"10286\",\n \"sender_account_type\": \"TRAN\",\n \"sender_document_number\": \"02020202020202\",\n \"sender_name\": \"João teste\",\n \"recipient_account_bank_code\": null,\n \"recipient_account_bank_ispb\": \"35624319\",\n \"recipient_account_bank_name\": \"MK DIGITAL \",\n \"recipient_account_branch\": \"3000\",\n \"recipient_account_number\": \"10170\",\n \"recipient_account_type\": \"TRAN\",\n \"recipient_document_number\": \"01010101010\",\n \"recipient_name\": \"João teste\",\n \"initialization_type\": \"MANU\",\n \"transaction_id\": null,\n \"addressing_key\": null,\n \"addressing_key_type\": null,\n \"has_been_locked\": false,\n \"legacy_order_id\": null,\n \"legacy_mocc_tabreg\": null,\n \"legacy_mocc_seqreg\": null,\n \"legacy_mocc_lanreg\": null,\n \"created_at\": \"2023-07-20T18:59:29.000000Z\",\n \"updated_at\": \"2023-07-20T18:59:29.000000Z\",\n \"correlation_id\": null\n }\n}" } }, "schema": { "type": "object", "properties": { "authentication_code": { "type": "string", "example": "9e2bd77c-300b-4b74-bca3-12fb0e8cea9d" }, "account_id": { "type": "integer", "example": 1060, "default": 0 }, "type": { "type": "string", "example": "CASH_OUT" }, "amount": { "type": "integer", "example": -8, "default": 0 }, "description": { "type": "string", "example": "Pagamento PIX" }, "complement": { "type": "string", "example": "João teste" }, "scheduling_date": { "type": "string", "example": "2023-07-20" }, "performed_at": {}, "performed_at_timestamp": {}, "status": { "type": "string", "example": "CREATED" }, "initiator": { "type": "string", "example": "API" }, "owner_id": { "type": "integer", "example": 83151, "default": 0 }, "owner_type": { "type": "string", "example": "App\\Models\\PixPayment" }, "updated_at": { "type": "string", "example": "2023-07-20T18:59:29.000000Z" }, "created_at": { "type": "string", "example": "2023-07-20T18:59:29.000000Z" }, "id": { "type": "integer", "example": 99005, "default": 0 }, "owner": { "type": "object", "properties": { "id": { "type": "integer", "example": 83151, "default": 0 }, "authentication_code": { "type": "string", "example": "d5d32688-8af4-4930-b663-1b54a7b088ff" }, "end_to_end_id": { "type": "string", "example": "E35624319202307201859F4ZdX8BeDg0" }, "account_id": { "type": "integer", "example": 1060, "default": 0 }, "amount": { "type": "integer", "example": 8, "default": 0 }, "notes": { "type": "string", "example": "Teste QA" }, "scheduling_date": { "type": "string", "example": "2023-07-20T18:59:29.000000Z" }, "performed_at": {}, "performed_at_timestamp": {}, "status": { "type": "string", "example": "CREATED" }, "reason": {}, "sender_account_bank_code": {}, "sender_account_bank_ispb": { "type": "string", "example": "35624319" }, "sender_account_bank_name": { "type": "string", "example": "MK Digital Bank S.A." }, "sender_account_branch": { "type": "string", "example": "3000" }, "sender_account_number": { "type": "string", "example": "10286" }, "sender_account_type": { "type": "string", "example": "TRAN" }, "sender_document_number": { "type": "string", "example": "02020202020202" }, "sender_name": { "type": "string", "example": "João teste" }, "recipient_account_bank_code": {}, "recipient_account_bank_ispb": { "type": "string", "example": "35624319" }, "recipient_account_bank_name": { "type": "string", "example": "MK DIGITAL " }, "recipient_account_branch": { "type": "string", "example": "3000" }, "recipient_account_number": { "type": "string", "example": "10170" }, "recipient_account_type": { "type": "string", "example": "TRAN" }, "recipient_document_number": { "type": "string", "example": "01010101010" }, "recipient_name": { "type": "string", "example": "João teste" }, "initialization_type": { "type": "string", "example": "MANU" }, "transaction_id": {}, "addressing_key": {}, "addressing_key_type": {}, "has_been_locked": { "type": "boolean", "example": false, "default": true }, "legacy_order_id": {}, "legacy_mocc_tabreg": {}, "legacy_mocc_seqreg": {}, "legacy_mocc_lanreg": {}, "created_at": { "type": "string", "example": "2023-07-20T18:59:29.000000Z" }, "updated_at": { "type": "string", "example": "2023-07-20T18:59:29.000000Z" }, "correlation_id": {} } } } } } } }, "422": { "description": "422", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"message\": \"The given document number was invalid.\",\n \"errors\": {\n \"recipient.document_number\": [\n \"The given document number was invalid.\"\n ]\n }\n}" } }, "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "The given document number was invalid." }, "errors": { "type": "object", "properties": { "recipient.document_number": { "type": "array", "items": { "type": "string", "example": "The given document number was invalid." } } } } } } } } } }, "deprecated": false } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true, "_id": "6297b52a229a9b00142bff3c:62a781e97fd7c7002f9c18eb" } ```