@@ -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 ===
4747The 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
7878The 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