Strictly / PayWithZero Public API

Payment Links (Deprecated)

Endpointhttps://api.paywithzero.net/v1

Download schema

deprecated

API get list of PaymentLink

GET

https://api.paywithzero.net/v1

/v1/public/payment-link

DEPRECATED — use GET /public/202104/payment-link instead. Returns paginated payment links.

API get list of PaymentLink › query Parameters

page

number

Page number for paginating

limit

number

Limit items per page

API get list of PaymentLink › Headers

authorization

string · required

API get list of PaymentLink › Responses

200

Paginated payment links (deprecated format).

object[]

total

integer

page

integer

limit

integer

deprecated

Create payment link

POST

https://api.paywithzero.net/v1

/v1/public/payment-link

DEPRECATED — use POST /public/202104/payment-link instead. customValues keys must be pre-configured in the merchant setup. Optionally include showBilling, showShipping, taxes, and attachments.

Create payment link › Headers

authorization

string · required

Create payment link › Request Body

amount

number · required

Pay amount

taxes

string[]

Taxes amount or list of taxes

showBilling

boolean

Show Billing

showShipping

boolean

Show Shipping

object[]

custom values data

attachments

string[]

Attachments

applyDiscount

boolean

A discount may be applied to this payment link. If applicable, a discount of {%} will be deducted from credit card payments.

Create payment link › Responses

Payment link created (deprecated format).

No data returned

POST/v1/public/payment-link

curl --request POST \
  --url https://api.paywithzero.net/v1/v1/public/payment-link \
  --header 'Content-Type: application/json' \
  --header 'authorization: <string>' \
  --data '
{
  "amount": 1,
  "customValues": [
    {
      "key": "customer_id",
      "label": "Customer ID",
      "value": "COD-123"
    }
  ],
  "showBilling": true,
  "showShipping": true,
  "taxes": [
    "653bd6ffbefb29d425276854"
  ]
}
'

shell

Example Request Body

{
  "amount": 1,
  "customValues": [
    {
      "key": "customer_id",
      "label": "Customer ID",
      "value": "COD-123"
    }
  ],
  "showBilling": true,
  "showShipping": true,
  "taxes": [
    "653bd6ffbefb29d425276854"
  ]
}

json

application/json

Example Responses

{
  "amount": 1,
  "taxes": 6,
  "selectedTaxes": [
    {
      "id": "653bd6ffbefb29d425276854",
      "clientId": "653a665504639e469f99096b",
      "taxName": "Washington",
      "percentage": 6,
      "_id": "694e771e9d17e6d8e640a52c"
    }
  ],
  "totalAmount": 1.06,
  "paid": false,
  "reference": "STR-CYT-251226-22877",
  "paidAmount": 0,
  "surcharge": 0,
  "discount": 0,
  "paymentMethod": null,
  "paidAt": null,
  "applyDiscount": false,
  "clientId": "653a665504639e469f99096b",
  "clientName": "Coders Strictly Tests",
  "status": "unpaid",
  "showBilling": true,
  "showShipping": true,
  "customValues": [
    {
      "key": "customer_id",
      "label": "Customer ID",
      "value": "COD-123",
      "valueLabel": ""
    }
  ],
  "createdBy": "email",
  "updatedBy": "email",
  "activity": [
    {
      "code": "Payment Link Created",
      "description": "Payment Link was created by username.",
      "date": "2025-12-26T11:53:02.705Z"
    }
  ],
  "sharedWith": [],
  "deletedAt": null,
  "payments": [],
  "attachments": [],
  "createdAt": "2025-12-26T11:53:02.709Z",
  "updatedAt": "2025-12-26T11:53:03.434Z",
  "paymentLink": ".zerospay.com/zpay/payment-request/694e771f9d17e6d8e640a52e",
  "paymentRequestId": "694e771f9d17e6d8e640a52e",
  "id": "694e771e9d17e6d8e640a52b"
}

json

application/json

deprecated

API view paymentLink by id

GET

https://api.paywithzero.net/v1

/v1/public/payment-link/{id}

DEPRECATED — use GET /public/202104/payment-link/:id instead.

API view paymentLink by id › path Parameters

id

string · required

Payment link ID

API view paymentLink by id › Headers

authorization

string · required

API view paymentLink by id › Responses

Payment link returned.

No data returned

GET/v1/public/payment-link/{id}

curl --request GET \
  --url https://api.paywithzero.net/v1/v1/public/payment-link/:id \
  --header 'authorization: <string>'

shell

Example Responses

{
  "data": {
    "amount": 3,
    "taxes": 0,
    "totalAmount": 3,
    "paid": false,
    "reference": "STR-CYT-251226-22911",
    "paidAmount": 2,
    "surcharge": 0.06,
    "discount": 0,
    "paymentMethod": {
      "billingAddress": null,
      "last4": "9586",
      "paymentToken": "c44a0a9b-9ebb-4d38-a9a6-e5ad2cf78d61",
      "type": "CARD",
      "metadata": {
        "ipAddress": "64.236.140.181",
        "loginDate": "2025-12-26T17:03:33.167Z",
        "submitDate": "2025-12-26T17:03:57.282Z",
        "user": "[email protected]"
      },
      "zipCode": "12656",
      "exp": "1229",
      "name": "John Doe",
      "cardType": "credit",
      "network": "mastercard",
      "brand": "mastercard",
      "number": "222300******9586",
      "bin": "22230000",
      "isSurchargeEligible": null,
      "isZipCodeEligible": null
    },
    "paidAt": "2025-12-26T17:04:02.537Z",
    "applyDiscount": false,
    "status": "partially-paid",
    "showBilling": true,
    "showShipping": true,
    "customValues": [
      {
        "key": "customer_id",
        "label": "Customer ID",
        "value": "Ramdom123",
        "valueLabel": ""
      },
      {
        "key": "Test1",
        "label": "Test1",
        "value": "Ramdom123",
        "valueLabel": ""
      }
    ],
    "createdBy": "[email protected]",
    "updatedBy": "online",
    "activity": [
      {
        "code": "Payment Link Created",
        "description": "Payment Link was created by Automated Testing User.",
        "date": "2025-12-26T17:03:30.056Z"
      },
      {
        "code": "Payment Link Shared",
        "description": "Payment Link was shared via copied Link.",
        "date": "2025-12-26T17:03:30.663Z"
      },
      {
        "code": "Payment Received",
        "description": "A payment for $2.00 was received using a Mastercard ending in 9586.\n                            Transaction ID: 1226170358.",
        "date": "2025-12-26T17:04:02.554Z"
      }
    ],
    "sharedWith": [],
    "deletedAt": null,
    "selectedTaxes": [],
    "payments": [
      {
        "type": "sale",
        "amountRefunded": 0,
        "paymentId": "694ec0027db6ff99147df7fe",
        "paidAmount": 200,
        "paidSurcharge": 6,
        "paidAt": "2025-12-26T17:04:02.537Z",
        "cardInfo": null,
        "paymentMethod": {
          "billingAddress": null,
          "last4": "9586",
          "paymentToken": "c44a0a9b-9ebb-4d38-a9a6-e5ad2cf78d61",
          "type": "CARD",
          "metadata": {
            "ipAddress": "64.236.140.181",
            "loginDate": "2025-12-26T17:03:33.167Z",
            "submitDate": "2025-12-26T17:03:57.282Z",
            "user": "[email protected]"
          },
          "zipCode": "12656",
          "exp": "1229",
          "name": "John Doe",
          "cardType": "credit",
          "network": "mastercard",
          "brand": "mastercard",
          "number": "222300******9586",
          "bin": "22230000",
          "isSurchargeEligible": null,
          "isZipCodeEligible": null
        },
        "transactionId": "1226170358"
      }
    ],
    "attachments": [],
    "createdAt": "2025-12-26T17:03:30.057Z",
    "updatedAt": "2025-12-26T17:04:02.599Z",
    "paymentLink": "https://merchant.zerospay.com/zpay/payment-request/694ebfe2fff33e2b6034718f",
    "cardInfo": {
      "paymentToken": "",
      "customerVaultId": "",
      "token": "",
      "last4": "",
      "billingAddress": null,
      "zipCode": "",
      "exp": "",
      "name": "",
      "type": "",
      "network": "",
      "brand": "",
      "number": ""
    },
    "cardPrice": 0,
    "cardTaxes": 0,
    "cashPrice": 0,
    "cashTaxes": 0,
    "totalCardAmount": 0,
    "totalCashAmount": 0,
    "paymentId": "694ec0027db6ff99147df7fe",
    "transactionId": "1226170358",
    "id": "694ebfe2fff33e2b6034718d"
  }
}

json

application/json

API delete paymentLink by id

DELETE

https://api.paywithzero.net/v1

/v1/public/payment-link/{id}

Delete a payment link (deprecated endpoint).

API delete paymentLink by id › path Parameters

id

string · required

Payment link ID

API delete paymentLink by id › Headers

authorization

string · required

API delete paymentLink by id › Responses

200

Payment link deleted.

No data returned

DELETE/v1/public/payment-link/{id}

curl --request DELETE \
  --url https://api.paywithzero.net/v1/v1/public/payment-link/:id \
  --header 'authorization: <string>'

shell

Example Responses

{
  "data": {
    "clientId": "60e856cce2819f4a3cfa4294",
    "order": {
      "currency": "USD",
      "amount": 100,
      "shipping": 0,
      "discount": 0,
      "tax": 0,
      "poNumber": "47498",
      "products": [],
      "customValues": [
        {
          "key": "external-identifier",
          "label": "External Identifier",
          "value": "356",
          "valueLabel": ""
        },
        {
          "key": "location",
          "label": "Location",
          "value": "florida",
          "valueLabel": "Florida"
        }
      ],
      "totalAmount": 100
    },
    "active": false,
    "from": "paymentLink",
    "fromId": "678a673d510ae75f40a1a0fc",
    "showBilling": true,
    "showShipping": true,
    "signedOrder": false,
    "deletedAt": "2025-02-21T01:59:21.305Z",
    "createdBy": "[email protected]",
    "updatedBy": "[email protected]",
    "owner": "[email protected]",
    "ownerGroup": null,
    "attachments": [],
    "createdAt": "2025-01-17T14:20:45.422Z",
    "updatedAt": "2025-02-21T01:59:21.309Z",
    "id": "678a673d510ae75f40a1a0fe"
  }
}

json

application/json

deprecated

API send the payment link by email

POST

https://api.paywithzero.net/v1

/v1/public/payment-link/send-by-email

DEPRECATED — use POST /public/202104/payment-link/send-by-email instead.

API send the payment link by email › Headers

authorization

string · required

API send the payment link by email › Request Body

email

string

paymentLinkId

string

API send the payment link by email › Responses

200

Email sent.

No data returned

deprecated

API send the payment link by sms

POST

https://api.paywithzero.net/v1

/v1/public/payment-link/send-by-sms

DEPRECATED — use POST /public/202104/payment-link/send-by-sms instead.

API send the payment link by sms › Headers

authorization

string · required

API send the payment link by sms › Request Body

phoneNumber

string

paymentLinkId

string

API send the payment link by sms › Responses

200

SMS sent.

No data returned

deprecated

Upload payment link attachments

POST

https://api.paywithzero.net/v1

/v1/public/payment-link/upload-attachments

DEPRECATED — use POST /public/202104/payment-link/upload-attachments instead. Upload files to attach to a payment link. Up to 10 files per request, max 25 MB total. Supported: JPG, PNG, PDF.

Upload payment link attachments › Request Body

file

string[] · application/octet-stream · required

Upload payment link attachments › Responses

Files uploaded.

No data returned

Payment Links Payment Requests

Strictly / PayWithZero Public API

Payment Links (Deprecated)

Endpointhttps://api.paywithzero.net/v1

Download schema

deprecated

API get list of PaymentLink

GET

https://api.paywithzero.net/v1

/v1/public/payment-link

DEPRECATED — use GET /public/202104/payment-link instead. Returns paginated payment links.

API get list of PaymentLink › query Parameters

page

number

Page number for paginating

limit

number

Limit items per page

API get list of PaymentLink › Headers

authorization

string · required

API get list of PaymentLink › Responses

200

Paginated payment links (deprecated format).

object[]

total

integer

page

integer

limit

integer

deprecated

Create payment link

POST

https://api.paywithzero.net/v1

/v1/public/payment-link

Create payment link › Headers

authorization

string · required

Create payment link › Request Body

amount

number · required

Pay amount

taxes

string[]

Taxes amount or list of taxes

showBilling

boolean

Show Billing

showShipping

boolean

Show Shipping

object[]

custom values data

attachments

string[]

Attachments

applyDiscount

boolean

A discount may be applied to this payment link. If applicable, a discount of {%} will be deducted from credit card payments.

Create payment link › Responses

Payment link created (deprecated format).

No data returned

POST/v1/public/payment-link

curl --request POST \
  --url https://api.paywithzero.net/v1/v1/public/payment-link \
  --header 'Content-Type: application/json' \
  --header 'authorization: <string>' \
  --data '
{
  "amount": 1,
  "customValues": [
    {
      "key": "customer_id",
      "label": "Customer ID",
      "value": "COD-123"
    }
  ],
  "showBilling": true,
  "showShipping": true,
  "taxes": [
    "653bd6ffbefb29d425276854"
  ]
}
'

shell

Example Request Body

{
  "amount": 1,
  "customValues": [
    {
      "key": "customer_id",
      "label": "Customer ID",
      "value": "COD-123"
    }
  ],
  "showBilling": true,
  "showShipping": true,
  "taxes": [
    "653bd6ffbefb29d425276854"
  ]
}

json

application/json

Example Responses

{
  "amount": 1,
  "taxes": 6,
  "selectedTaxes": [
    {
      "id": "653bd6ffbefb29d425276854",
      "clientId": "653a665504639e469f99096b",
      "taxName": "Washington",
      "percentage": 6,
      "_id": "694e771e9d17e6d8e640a52c"
    }
  ],
  "totalAmount": 1.06,
  "paid": false,
  "reference": "STR-CYT-251226-22877",
  "paidAmount": 0,
  "surcharge": 0,
  "discount": 0,
  "paymentMethod": null,
  "paidAt": null,
  "applyDiscount": false,
  "clientId": "653a665504639e469f99096b",
  "clientName": "Coders Strictly Tests",
  "status": "unpaid",
  "showBilling": true,
  "showShipping": true,
  "customValues": [
    {
      "key": "customer_id",
      "label": "Customer ID",
      "value": "COD-123",
      "valueLabel": ""
    }
  ],
  "createdBy": "email",
  "updatedBy": "email",
  "activity": [
    {
      "code": "Payment Link Created",
      "description": "Payment Link was created by username.",
      "date": "2025-12-26T11:53:02.705Z"
    }
  ],
  "sharedWith": [],
  "deletedAt": null,
  "payments": [],
  "attachments": [],
  "createdAt": "2025-12-26T11:53:02.709Z",
  "updatedAt": "2025-12-26T11:53:03.434Z",
  "paymentLink": ".zerospay.com/zpay/payment-request/694e771f9d17e6d8e640a52e",
  "paymentRequestId": "694e771f9d17e6d8e640a52e",
  "id": "694e771e9d17e6d8e640a52b"
}

json

application/json

deprecated

API view paymentLink by id

GET

https://api.paywithzero.net/v1

/v1/public/payment-link/{id}

DEPRECATED — use GET /public/202104/payment-link/:id instead.

API view paymentLink by id › path Parameters

id

string · required

Payment link ID

API view paymentLink by id › Headers

authorization

string · required

API view paymentLink by id › Responses

Payment link returned.

No data returned

GET/v1/public/payment-link/{id}

curl --request GET \
  --url https://api.paywithzero.net/v1/v1/public/payment-link/:id \
  --header 'authorization: <string>'

shell

Example Responses

{
  "data": {
    "amount": 3,
    "taxes": 0,
    "totalAmount": 3,
    "paid": false,
    "reference": "STR-CYT-251226-22911",
    "paidAmount": 2,
    "surcharge": 0.06,
    "discount": 0,
    "paymentMethod": {
      "billingAddress": null,
      "last4": "9586",
      "paymentToken": "c44a0a9b-9ebb-4d38-a9a6-e5ad2cf78d61",
      "type": "CARD",
      "metadata": {
        "ipAddress": "64.236.140.181",
        "loginDate": "2025-12-26T17:03:33.167Z",
        "submitDate": "2025-12-26T17:03:57.282Z",
        "user": "[email protected]"
      },
      "zipCode": "12656",
      "exp": "1229",
      "name": "John Doe",
      "cardType": "credit",
      "network": "mastercard",
      "brand": "mastercard",
      "number": "222300******9586",
      "bin": "22230000",
      "isSurchargeEligible": null,
      "isZipCodeEligible": null
    },
    "paidAt": "2025-12-26T17:04:02.537Z",
    "applyDiscount": false,
    "status": "partially-paid",
    "showBilling": true,
    "showShipping": true,
    "customValues": [
      {
        "key": "customer_id",
        "label": "Customer ID",
        "value": "Ramdom123",
        "valueLabel": ""
      },
      {
        "key": "Test1",
        "label": "Test1",
        "value": "Ramdom123",
        "valueLabel": ""
      }
    ],
    "createdBy": "[email protected]",
    "updatedBy": "online",
    "activity": [
      {
        "code": "Payment Link Created",
        "description": "Payment Link was created by Automated Testing User.",
        "date": "2025-12-26T17:03:30.056Z"
      },
      {
        "code": "Payment Link Shared",
        "description": "Payment Link was shared via copied Link.",
        "date": "2025-12-26T17:03:30.663Z"
      },
      {
        "code": "Payment Received",
        "description": "A payment for $2.00 was received using a Mastercard ending in 9586.\n                            Transaction ID: 1226170358.",
        "date": "2025-12-26T17:04:02.554Z"
      }
    ],
    "sharedWith": [],
    "deletedAt": null,
    "selectedTaxes": [],
    "payments": [
      {
        "type": "sale",
        "amountRefunded": 0,
        "paymentId": "694ec0027db6ff99147df7fe",
        "paidAmount": 200,
        "paidSurcharge": 6,
        "paidAt": "2025-12-26T17:04:02.537Z",
        "cardInfo": null,
        "paymentMethod": {
          "billingAddress": null,
          "last4": "9586",
          "paymentToken": "c44a0a9b-9ebb-4d38-a9a6-e5ad2cf78d61",
          "type": "CARD",
          "metadata": {
            "ipAddress": "64.236.140.181",
            "loginDate": "2025-12-26T17:03:33.167Z",
            "submitDate": "2025-12-26T17:03:57.282Z",
            "user": "[email protected]"
          },
          "zipCode": "12656",
          "exp": "1229",
          "name": "John Doe",
          "cardType": "credit",
          "network": "mastercard",
          "brand": "mastercard",
          "number": "222300******9586",
          "bin": "22230000",
          "isSurchargeEligible": null,
          "isZipCodeEligible": null
        },
        "transactionId": "1226170358"
      }
    ],
    "attachments": [],
    "createdAt": "2025-12-26T17:03:30.057Z",
    "updatedAt": "2025-12-26T17:04:02.599Z",
    "paymentLink": "https://merchant.zerospay.com/zpay/payment-request/694ebfe2fff33e2b6034718f",
    "cardInfo": {
      "paymentToken": "",
      "customerVaultId": "",
      "token": "",
      "last4": "",
      "billingAddress": null,
      "zipCode": "",
      "exp": "",
      "name": "",
      "type": "",
      "network": "",
      "brand": "",
      "number": ""
    },
    "cardPrice": 0,
    "cardTaxes": 0,
    "cashPrice": 0,
    "cashTaxes": 0,
    "totalCardAmount": 0,
    "totalCashAmount": 0,
    "paymentId": "694ec0027db6ff99147df7fe",
    "transactionId": "1226170358",
    "id": "694ebfe2fff33e2b6034718d"
  }
}

json

application/json

API delete paymentLink by id

DELETE

https://api.paywithzero.net/v1

/v1/public/payment-link/{id}

Delete a payment link (deprecated endpoint).

API delete paymentLink by id › path Parameters

id

string · required

Payment link ID

API delete paymentLink by id › Headers

authorization

string · required

API delete paymentLink by id › Responses

200

Payment link deleted.

No data returned

DELETE/v1/public/payment-link/{id}

curl --request DELETE \
  --url https://api.paywithzero.net/v1/v1/public/payment-link/:id \
  --header 'authorization: <string>'

shell

Example Responses

{
  "data": {
    "clientId": "60e856cce2819f4a3cfa4294",
    "order": {
      "currency": "USD",
      "amount": 100,
      "shipping": 0,
      "discount": 0,
      "tax": 0,
      "poNumber": "47498",
      "products": [],
      "customValues": [
        {
          "key": "external-identifier",
          "label": "External Identifier",
          "value": "356",
          "valueLabel": ""
        },
        {
          "key": "location",
          "label": "Location",
          "value": "florida",
          "valueLabel": "Florida"
        }
      ],
      "totalAmount": 100
    },
    "active": false,
    "from": "paymentLink",
    "fromId": "678a673d510ae75f40a1a0fc",
    "showBilling": true,
    "showShipping": true,
    "signedOrder": false,
    "deletedAt": "2025-02-21T01:59:21.305Z",
    "createdBy": "[email protected]",
    "updatedBy": "[email protected]",
    "owner": "[email protected]",
    "ownerGroup": null,
    "attachments": [],
    "createdAt": "2025-01-17T14:20:45.422Z",
    "updatedAt": "2025-02-21T01:59:21.309Z",
    "id": "678a673d510ae75f40a1a0fe"
  }
}

json

application/json

deprecated

API send the payment link by email

POST

https://api.paywithzero.net/v1

/v1/public/payment-link/send-by-email

DEPRECATED — use POST /public/202104/payment-link/send-by-email instead.

API send the payment link by email › Headers

authorization

string · required

API send the payment link by email › Request Body

email

string

paymentLinkId

string

API send the payment link by email › Responses

200

Email sent.

No data returned

deprecated

API send the payment link by sms

POST

https://api.paywithzero.net/v1

/v1/public/payment-link/send-by-sms

DEPRECATED — use POST /public/202104/payment-link/send-by-sms instead.

API send the payment link by sms › Headers

authorization

string · required

API send the payment link by sms › Request Body

phoneNumber

string

paymentLinkId

string

API send the payment link by sms › Responses

200

SMS sent.

No data returned

deprecated

Upload payment link attachments

POST

https://api.paywithzero.net/v1

/v1/public/payment-link/upload-attachments

DEPRECATED — use POST /public/202104/payment-link/upload-attachments instead. Upload files to attach to a payment link. Up to 10 files per request, max 25 MB total. Supported: JPG, PNG, PDF.

Upload payment link attachments › Request Body

file

string[] · application/octet-stream · required

Upload payment link attachments › Responses

Files uploaded.

No data returned

Payment Links Payment Requests