Point of Sale Integration
Notifications
Web SDK Anypay.js
Payments API
Pay Protocol
Anypay City
Gift Cards
Wallet Overview
Wallets communicate with Pay: Protocol servers to coordinate perfect payments with scalable efficiency.
Detecting pay: Codes
pay: Codespay: Protocol codes may be differentiated from other forms of QR codes or links by its signature parameter regardless of the protocol prefix.Always look for URIs that include ?r=https
?r=httpsWhenever you encounter a code like the one above consider it is likely a payment request.
1
pay:?r=https://api.anypayinc.com/r/LeO7itGT4
Copied!
By making your app respond to
pay: as a URI prefix it can handly multi-currency payment requests without bothering your users.Anypay currently supports four coins at our
pay: protocol server BCH, BSV, BTC, DASHOne you find a Pay Protocol URI download the contents by specifying your desired coin in the
x-currency header, including an Accept header telling the server to return a payment request.Downloading the Payment Request Template
fetch_payment_request.sh
1
# One single URL serves payment requests for multiple coins
2
# Always include these two headers, switching BCH for you coin.
3
curl -H 'Accept: application/payment-request' \
4
-H 'x-currency: BCH' \
5
https://api.anypayinc.com/r/LeO7itGT4
Copied!
The Payment Request Template will include one or more outputs, which are comprised of an amount and an address.
1
{
2
"network": "main",
3
"currency": "BCH",
4
"requiredFeeRate": 1,
5
"outputs": [
6
{
7
"amount": 17400,
8
"address": "qztlw4ft8euq9wvzk27hh6lxtac2z4clay0w8v79zm"
9
},
10
{
11
"amount": 3000,
12
"address": "qrggz7d0sgv4v3d0jl7lj4mv2vdnv0vqjsq48qtvt6"
13
}
14
],
15
"time": "2020-08-12T21:21:03.034Z",
16
"expires": "2020-08-12T21:36:03.034Z",
17
"memo": "Payment request for Anypay invoice LeO7itGT4",
18
"paymentUrl": "https://api.anypayinc.com/payments/json/BCH/LeO7itGT4",
19
"paymentId": "LeO7itGT4"
20
}
Copied!
Submitting Your Transaction
Each Payment Request Template includes a
paymentUrl property to which your app will submit the signed transaction built with the required outptus.submit_payment_request
1
# One single URL serves payment requests for multiple coins
2
# Always include these two headers, switching BCH for you coin.
3
curl -X POST -H 'Content-Type: application/json' \
4
-d '{"currency": "BCH", "transactions":["0100000001cf787c9d2fdd2fefc6e7088793832c8e3878177d283f469f24d27148c68b1640020000006a473044022019aa76373fd2780333705196ef36cf073bae6f7ccdf6bbaa99353fc7679bf18002204de998f9d751bd6d782026248f9840c845419c392640fe158dc7788a27c75b854121023e9d690dd349aa4fe9b972db21995f55c68744555950d4f714d3f9fd7b74a26bffffffff03f8430000000000001976a91497f7552b3e7802b982b2bd7bebe65f70a1571fe988acb80b0000000000001976a914d08179af82195645af97fdf9576c531b363d809488ac8ab71000000000001976a914b50c540608e9e54e83afb6c9666c33568d2d407188ac00000000"]}' \
5
https://api.anypayinc.com/payments/json/BCH/LeO7itGT4
Copied!
Anypay's server will first verify the correctness of your transaction and broadcast it to the validation network (miners). Finally the server returns a successful response and your wallet app may broadcast the transaction to your network of validators.
1
{
2
"success": true,
3
"transactions": ["0100000001cf787c9d2fdd2fefc6e7088793832c8e3878177d283f469f24d27148c68b1640020000006a473044022019aa76373fd2780333705196ef36cf073bae6f7ccdf6bbaa99353fc7679bf18002204de998f9d751bd6d782026248f9840c845419c392640fe158dc7788a27c75b854121023e9d690dd349aa4fe9b972db21995f55c68744555950d4f714d3f9fd7b74a26bffffffff03f8430000000000001976a91497f7552b3e7802b982b2bd7bebe65f70a1571fe988acb80b0000000000001976a914d08179af82195645af97fdf9576c531b363d809488ac8ab71000000000001976a914b50c540608e9e54e83afb6c9666c33568d2d407188ac00000000"]
4
}
Copied!
Handling Error Responses
Sometimes your transaction may be rejected by your peer for one or more reasons. Anypay's servers may reject the transaction if it does not contain the correct amounts, or has an insufficient fee, or if the coins are already spent.
The server may also reject your transaction for one or more app-specific reasons such as an invoice that was already paid or manually cancelled or the exchange rate was expired.
Any HTTP Status Code Other Than 2xx Is An Error
400 Bad Request
1
{
2
"success": false,
3
"error": "Insufficient Amount to Output 0"
4
}
Copied!
500 Internal Server Error
1
{
2
"success": false,
3
"error": "No Connection To The Validation Network"
4
}
Copied!
IN THE CASE OF AN ERROR DO NOT BROADCAST THE TRANSACTIONYour app may try again to pay the invoice but do not broadcast the transaction. Only transactions sent directly to the Anypay server will be noticed and processed by our system.
Last modified 1yr ago