{"id":271,"date":"2023-06-12T14:27:14","date_gmt":"2023-06-12T14:27:14","guid":{"rendered":"https:\/\/developers.10npay.com\/?post_type=docs&p=300"},"modified":"2023-06-12T14:27:14","modified_gmt":"2023-06-12T14:27:14","password":"","slug":"initiate-payment","status":"publish","type":"docs","link":"https:\/\/developers.10npay.com\/bg\/docs\/initiate-payment\/","title":{"rendered":"Initiate payment"},"content":{"rendered":"\n

In the body of the request, data about the payment itself is sent:
instructedAmount \u2013 amount and currency
debtorAccount \u2013 IBAN of the payer
creditorAccount \u2013 IBAN of the payee
creditorName \u2013 name of the payee
other fields are optional.
A unique ID is created for the payment, and if a payment request is successfully created, links for further operations are returned in the response – payment information (self), payment status (status), authorization operations (authoriseTransaction)<\/p>\n\n\n\n

POST http:\/\/[ip]:[port]\/psd2\/v1\/payments\/bgn-credit-transfers
HEADERS:
X-Request-ID: [request-id] – required
Content-Type: application\/json – required
PSU-ID: [user-id] \u2013 user ID received at login, required<\/p>\n\n\n\n

Request:<\/p>\n\n\n\n

{\r\n   \"instructedAmount\":{\r\n      \"currency\":\"USD\",\r\n      \"content\":\"123.50\"\r\n   },\r\n   \"debtorAccount\":{\r\n      \"iban\":\"DE2310010010123456789\"\r\n   },\r\n   \"creditorName\":\"IhuAhu.com\",\r\n   \"creditorAccount\":{\r\n      \"iban\":\"TR73TURKBANK123456789\"\r\n   },\r\n   \"paymentType\" : {\"serviceLevel\" : \"SS1\"},\r\n   \"remittanceInformationUnstructured\": \"ihuahu link\"   \r\n}\r<\/code><\/pre>\n\n\n\n
Response:<\/p>\n\n\n\n
{<\/p>\n\n\n\n
  “transactionStatus”: “RCVD”,<\/p>\n\n\n\n
  “paymentId”: “526091c1-e4ac-410a-a642-65af191ee8a9”,<\/p>\n\n\n\n
  “_links”: {<\/p>\n\n\n\n
    “self”: {<\/p>\n\n\n\n
      “href”: “\/v1\/payments\/bgn-credit-transfer\/526091c1-e4ac-410a-a642-65af191ee8a9”<\/p>\n\n\n\n
    },<\/p>\n\n\n\n
    “status”: {<\/p>\n\n\n\n
      “href”: “\/v1\/payments\/bgn-credit-transfer\/526091c1-e4ac-410a-a642-65af191ee8a9\/status”<\/p>\n\n\n\n
    },<\/p>\n\n\n\n
    “authoriseTransaction”: {<\/p>\n\n\n\n
      “href”:”\/v1\/payments\/bgn-credit-transfer\/526091c1-e4ac-410a-a642-65af191ee8a9\/authorisations”<\/p>\n\n\n\n
    }<\/p>\n\n\n\n
  }<\/p>\n\n\n\n
}<\/p>\n","protected":false},"excerpt":{"rendered":"
In the body of the request, data about the payment itself is sent:instructedAmount \u2013 amount and currencydebtorAccount \u2013 IBAN of the payercreditorAccount \u2013 IBAN of the payeecreditorName \u2013 name of the payeeother fields are optional.A unique ID is created for the payment, and if a payment request is successfully created, links for further operations are […]<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"doc_category":[],"doc_tag":[],"knowledge_base":[33],"class_list":["post-271","docs","type-docs","status-publish","hentry","knowledge_base-10npay"],"year_month":"2026-07","word_count":202,"total_views":0,"reactions":{"happy":0,"normal":0,"sad":0},"author_info":{"name":"","author_nicename":"","author_url":"https:\/\/developers.10npay.com\/bg\/author\/"},"doc_category_info":[],"doc_tag_info":[],"knowledge_base_info":[{"term_name":"10npay","term_url":"https:\/\/developers.10npay.com\/bg\/docs\/10npay\/","term_slug":"10npay"}],"knowledge_base_slug":["10npay"],"_links":{"self":[{"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/docs\/271","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\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/comments?post=271"}],"version-history":[{"count":0,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/docs\/271\/revisions"}],"wp:attachment":[{"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/media?parent=271"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/doc_category?post=271"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/doc_tag?post=271"},{"taxonomy":"knowledge_base","embeddable":true,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/knowledge_base?post=271"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}