Skip to content

Commit e71e572

Browse files
author
Matt David
committed
- Fix section levels
- Add Message Interaction Details + new mimetypes
1 parent 845f240 commit e71e572

1 file changed

Lines changed: 24 additions & 8 deletions

File tree

bip-invoicerequest-extension.mediawiki

Lines changed: 24 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ to facilitate identification for address release.
3232
| Receiver || Entity receiving a value transfer
3333
|}
3434

35-
===Acronyms===
35+
==Acronyms==
3636
{| class="wikitable"
3737
! Acronym !! Expanded !! Description
3838
|-
@@ -41,9 +41,9 @@ to facilitate identification for address release.
4141
| RPR || ReturnPaymentRequest || A ReturnPaymentRequest returned based on a submitted InvoiceRequest
4242
|}
4343

44-
===New Messages===
44+
==New Messages==
4545

46-
====InvoiceRequest====
46+
===InvoiceRequest===
4747
The new InvoiceRequest message allows a requestor to send information to the responder such that they can return a ReturnPaymentRequest.
4848

4949
<pre>
@@ -68,12 +68,12 @@ message InvoiceRequest {
6868
|-
6969
| pki_data || Depends on pki_type
7070
|-
71-
| notification_url || URL to notify on ReturnPaymentRequest ready
71+
| notification_url || Secure (usually HTTPS) location where a ReturnPaymentRequest (see below) may be sent when ready
7272
|-
7373
| signature || PKI-dependent signature
7474
|}
7575

76-
====ReturnPaymentRequest====
76+
===ReturnPaymentRequest===
7777

7878
The new ReturnPaymentRequest message is an encapsulating message that allows the transmission of an encrypted, serialized PaymentRequest.
7979

@@ -111,12 +111,28 @@ The new ReturnPaymentRequest message is an encapsulating message that allows the
111111
# Sender validates ReturnPaymentRequest
112112
# Sender decrypts and validates encrypted PaymentRequest
113113
114+
===Message Interaction Details===
115+
116+
====InvoiceRequest====
117+
Sender must transmit InvoiceRequest to Receiver (or Receiver's agent) via TLS-protected HTTP. Sender transmitting InvoiceRequest
118+
messages must set appropriate Content-Type headers as specified here:
119+
<pre>Content-Type: application/bitcoin-invoicerequest</pre>
120+
121+
====ReturnPaymentRequest====
122+
Receiver must transmit ReturnPaymentRequest to Sender (or Sender's agent) via TLS-protected HTTP. Receiver transmitting
123+
ReturnPaymentRequest messages must set appropritate Content-Type headers as specified here:
124+
<pre>Content-Type: application/bitcoin-returnpaymentrequest</pre>
125+
126+
====Message or Communication Errors====
127+
An invalid or unparsable message or communications error must be communicated to the party that initiated the communication. This
128+
should be done through standard HTTP Status Code messaging ([https://tools.ietf.org/html/rfc7231 RFC 7231 Section 6]).
129+
114130
===InvoiceRequest Message Creation===
115131

116132
* Create an InvoiceRequest message
117-
* sender_public_key MUST be set. This is the public key of an EC keypair using secp256k1.
118-
* Set amount if desired
119-
* Set notification_url to URL that Receiver will submit completed ReturnPaymentRequest to
133+
* sender_public_key MUST be set to the public key of an EC keypair.
134+
* Amount is optional
135+
* Set notification_url to URL that the Receiver will submit completed ReturnPaymentRequest to
120136
* If NOT including certificate, set pki_type to "none"
121137
* If including certificate:
122138
** Set pki_type to "x509+sha256"

0 commit comments

Comments
 (0)