{"id":223,"date":"2023-08-22T11:18:35","date_gmt":"2023-08-22T11:18:35","guid":{"rendered":"https:\/\/developers.10npay.com\/docs\/payment-initiation\/"},"modified":"2026-05-28T10:08:53","modified_gmt":"2026-05-28T10:08:53","password":"","slug":"payment-initiation","status":"publish","type":"docs","link":"https:\/\/developers.10npay.com\/bg\/docs\/payment-initiation\/","title":{"rendered":"Initiate Payment"},"content":{"rendered":"<p><span style=\"font-size: 20px;\">The data about the payment are in the body request:<\/span><\/p>\n<p><span style=\"font-size: 20px;\"><strong>instructedAmount<\/strong> \u2013 amount and currency<\/span><br \/>\n<span style=\"font-size: 20px;\"><strong>debtorAccount<\/strong> \u2013 payer&#8217;s IBAN<\/span><br \/>\n<span style=\"font-size: 20px;\"><strong>creditorAccount<\/strong> \u2013 recipient&#8217;s IBAN<\/span><br \/>\n<span style=\"font-size: 20px;\"><strong>creditorName<\/strong> \u2013 recipient&#8217;s name<\/span><\/p>\n<p><span style=\"font-size: 20px;\"><strong>The other fields are optional.<\/strong><\/span><br \/>\n<span style=\"font-size: 20px;\">A unique ID is generated for the payment, and upon successful creation of a payment request, links for further operations are returned in the response \u2013 payment information (self), payment status (status), and authorization operations (authoriseTransaction).<\/span><\/p>\n<h5><span style=\"font-size: 20px;\"><strong>End-point URL<\/strong><\/span><\/h5>\n<p><span style=\"font-size: 20px;\"><div class=\"dm-code-snippet dark default  dm-normal-version\" style=\"background-color:#abb8c3;\" snippet-height=\"\">\n\t\t\t<div class=\"control-language\">\n                <div class=\"dm-buttons\">\n                    <div class=\"dm-buttons-left\">\n                        <div class=\"dm-button-snippet red-button\"><\/div>\n                        <div class=\"dm-button-snippet orange-button\"><\/div>\n                        <div class=\"dm-button-snippet green-button\"><\/div>\n                    <\/div>\n                    <div class=\"dm-buttons-right\">\n                        <a id=\"dm-copy-raw-code\">\n                        <span class=\"dm-copy-text\">Copy Code<\/span>\n                        <span class=\"dm-copy-confirmed\" style=\"display:none\">Copied<\/span>\n                        <span class=\"dm-error-message\" style=\"display:none\">Use a different Browser<\/span><\/a>\n                    <\/div>\n                <\/div>\n                <pre class=\"no-line-numbers\"><code id=\"dm-code-raw\" class=\"wrap language-php\"><\/span><\/p>\n<pre class=\"dm-pre-admin-side\"><span style=\"font-size: 20px;\">http:\/\/[ip]:[port]\/psd2\/v1\/payments\/domestic-credit-transfers-bgn<\/span><\/pre>\n<p><span style=\"font-size: 20px;\"><\/code><\/pre>\n\t\t\t<\/div>\n        <\/div><\/span><\/p>\n<p><span style=\"font-size: 20px;\"><strong>Method:<\/strong> POST\u00a0<\/span><\/p>\n<h5><span style=\"font-size: 20px;\">Headers<\/span><\/h5>\n<ul>\n<li><span style=\"font-size: 20px;\"><strong>X-Request-ID:<\/strong> [request-id] \u2013 Required: A unique request ID (GUID).<\/span><\/li>\n<li><span style=\"font-size: 20px;\"><strong>Content-Type:<\/strong> application\/json \u2013 Required: Specifies the request format.<\/span><\/li>\n<li><span style=\"font-size: 20px;\"><strong>PSU-ID:<\/strong> [user-id] \u2013 Required: User identifier obtained upon login.<\/span><\/li>\n<\/ul>\n<h5><span style=\"font-size: 20px;\">Request Body<\/span><\/h5>\n<p><span style=\"font-size: 20px;\"><div class=\"dm-code-snippet dark default  dm-normal-version\" style=\"background-color:#abb8c3;\" snippet-height=\"\">\n\t\t\t<div class=\"control-language\">\n                <div class=\"dm-buttons\">\n                    <div class=\"dm-buttons-left\">\n                        <div class=\"dm-button-snippet red-button\"><\/div>\n                        <div class=\"dm-button-snippet orange-button\"><\/div>\n                        <div class=\"dm-button-snippet green-button\"><\/div>\n                    <\/div>\n                    <div class=\"dm-buttons-right\">\n                        <a id=\"dm-copy-raw-code\">\n                        <span class=\"dm-copy-text\">Copy Code<\/span>\n                        <span class=\"dm-copy-confirmed\" style=\"display:none\">Copied<\/span>\n                        <span class=\"dm-error-message\" style=\"display:none\">Use a different Browser<\/span><\/a>\n                    <\/div>\n                <\/div>\n                <pre class=\"no-line-numbers\"><code id=\"dm-code-raw\" class=\"wrap language-php\"><\/span><\/p>\n<pre class=\"dm-pre-admin-side\"><span style=\"font-size: 20px;\">{\r\n\t\"instructedAmount\": {\r\n\t\t\"currency\": \"USD\",\r\n\t\t\"amount\": \"123.50\"\r\n\t},\r\n\t\"debtorAccount\": {\r\n\t\t\"iban\": \"BG53TEPJ40131001000119\"\r\n\t},\r\n\t\"creditorName\": \"IhuAhu.com\",\r\n\t\"creditorAccount\": {\r\n\t\t\"iban\": \"TR73TURKBANK123456789\"\r\n\t},\r\n\t\"paymentType\": {\r\n\t\t\"serviceLevel\": \"SS1\"\r\n\t},\r\n\t\"remittanceInformationUnstructured\": \"ihuahu link\"\r\n}<\/span><\/pre>\n<p><span style=\"font-size: 20px;\"><\/code><\/pre>\n\t\t\t<\/div>\n        <\/div><\/span><\/p>\n<h5><span style=\"font-size: 20px;\"><strong>Response<\/strong><\/span><\/h5>\n<p><span style=\"font-size: 20px;\"><div class=\"dm-code-snippet dark default  dm-normal-version\" style=\"background-color:#abb8c3;\" snippet-height=\"\">\n\t\t\t<div class=\"control-language\">\n                <div class=\"dm-buttons\">\n                    <div class=\"dm-buttons-left\">\n                        <div class=\"dm-button-snippet red-button\"><\/div>\n                        <div class=\"dm-button-snippet orange-button\"><\/div>\n                        <div class=\"dm-button-snippet green-button\"><\/div>\n                    <\/div>\n                    <div class=\"dm-buttons-right\">\n                        <a id=\"dm-copy-raw-code\">\n                        <span class=\"dm-copy-text\">Copy Code<\/span>\n                        <span class=\"dm-copy-confirmed\" style=\"display:none\">Copied<\/span>\n                        <span class=\"dm-error-message\" style=\"display:none\">Use a different Browser<\/span><\/a>\n                    <\/div>\n                <\/div>\n                <pre class=\"no-line-numbers\"><code id=\"dm-code-raw\" class=\"no-wrap language-php\"><\/span><\/p>\n<pre class=\"dm-pre-admin-side\"><span style=\"font-size: 20px;\">{\r\n\t\"transactionStatus\": \"RCVD\",\r\n\t\"paymentId\": \"526091c1-e4ac-410a-a642-65af191ee8a9\",\r\n\t\"_links\": {\r\n\t\t\"self\": {\r\n\t\t\t\"href\": \"\/v1\/payments\/bgn-credit-transfer\/526091c1-e4ac-410a-a642-65af191ee8a9\"\r\n\t\t},\r\n\t\t\"status\": {\r\n\t\t\t\"href\": \"\/v1\/payments\/bgn-credit-transfer\/526091c1-e4ac-410a-a642-65af191ee8a9\/status\"\r\n\t\t},\r\n\t\t\"authoriseTransaction\": {\r\n\t\t\t\"href\": \"\/v1\/payments\/bgn-credit-transfer\/526091c1-e4ac-410a-a642-65af191ee8a9\/authorisations\"\r\n\t\t}\r\n\t}\r\n}<\/span><\/pre>\n<p><span style=\"font-size: 20px;\"><\/code><\/pre>\n\t\t\t<\/div>\n        <\/div><\/span><\/p>\n<h5><span style=\"font-size: 20px;\">Remarks<\/span><\/h5>\n<p><span style=\"font-size: 20px;\">The transactionStatus field indicates the current status of the payment request.<\/span><br \/>\n<span style=\"font-size: 20px;\">The paymentId uniquely identifies this payment request.<\/span><br \/>\n<span style=\"font-size: 20px;\">Links (_links) are provided for accessing the payment details (self), checking payment status (status), and authorizing the transaction (authoriseTransaction).<\/span><\/p>\n<h5><span style=\"font-size: 20px;\">Snippet<\/span><\/h5>\n<p><span style=\"font-size: 20px;\">[codesnippet id=&#8221;10&#8243;]<\/span><\/p>\n","protected":false},"excerpt":{"rendered":"<p>The data about the payment are in the body request: instructedAmount \u2013 amount and currency debtorAccount \u2013 payer&#8217;s IBAN creditorAccount \u2013 recipient&#8217;s IBAN creditorName \u2013 recipient&#8217;s name The other fields are optional. A unique ID is generated for the payment, and upon successful creation of a payment request, links for further operations are returned in [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"doc_category":[41],"doc_tag":[],"knowledge_base":[34],"class_list":["post-223","docs","type-docs","status-publish","hentry","doc_category-lll-pisp-payments","knowledge_base-psd2"],"year_month":"2026-05","word_count":304,"total_views":0,"reactions":{"happy":0,"normal":0,"sad":0},"author_info":{"name":"10npaydev","author_nicename":"10npaydev","author_url":"https:\/\/developers.10npay.com\/bg\/author\/10npaydev\/"},"doc_category_info":[{"term_name":"lV. PIS - Payment Initiation Services","term_url":"https:\/\/developers.10npay.com\/bg\/docs\/psd2\/lll-pisp-payments\/"}],"doc_tag_info":[],"knowledge_base_info":[{"term_name":"psd2","term_url":"https:\/\/developers.10npay.com\/bg\/docs\/psd2\/","term_slug":"psd2"}],"knowledge_base_slug":["psd2"],"_links":{"self":[{"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/docs\/223","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/comments?post=223"}],"version-history":[{"count":2,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/docs\/223\/revisions"}],"predecessor-version":[{"id":453,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/docs\/223\/revisions\/453"}],"wp:attachment":[{"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/media?parent=223"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/doc_category?post=223"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/doc_tag?post=223"},{"taxonomy":"knowledge_base","embeddable":true,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/knowledge_base?post=223"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}