Wallet Overview

Detecting pay: Codes
pay: 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
Whenever you encounter a code like the one above consider it is likely a payment request.
1
pay:?r=https://api.anypayx.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, DASH
One 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.anypayx.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.anypayx.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.anypayx.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 TRANSACTION
Your 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.
​

Payments API - Previous

Node.js SDK

Next - Pay Protocol

JSON API Spec

Last modified 3mo ago

Copy link

Contents

Detecting pay: Codes

Always look for URIs that include ?r=https

Downloading the Payment Request Template

Submitting Your Transaction

Handling Error Responses

Detecting `pay:` Codes

Always look for URIs that include `?r=https`

Downloading the Payment Request Template

Submitting Your Transaction

Handling Error Responses

Any HTTP Status Code Other Than 2xx Is An Error