Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Ripple Labs Request for payment API

Use these operations to interact with your payment requests.| Operation | Method | Description || -- | -- | -- || [Get requests for payment](/products/payments-odl/api-docs/ripplenet/reference/openapi/request-for-payment/getrequestsforpayment) | GET | Gets requests for payment that match the query parameters. || [Send request for payment](/products/payments-odl/api-docs/ripplenet/reference/openapi/request-for-payment/sendrequestforpayment) | POST | Sends a new request for payment. || [Get request for payment by ID](/products/payments-odl/api-docs/ripplenet/reference/openapi/request-for-payment/getrequestforpaymentbyid) | GET | Gets a request for payment by request for payment ID. || [Accept request for payment](/products/payments-odl/api-docs/ripplenet/reference/openapi/request-for-payment/acceptrequestforpayment) | POST | Accepts a request for payment. || [Fail request for payment](/products/payments-odl/api-docs/ripplenet/reference/openapi/request-for-payment/failrequestforpayment) | POST | Fails a request for payment. |

Ripple Labs Request for payment API is one of 36 APIs that Ripple Labs publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Request for payment. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and authentication docs.

This API exposes 5 operations across 4 paths, and defines 10 schemas. It is described by OpenAPI 3.0.0, at version 2.0.

Requests are made against 2 base URLs: https://api.sandbox.palisade.co, https://api.palisade.co.

5 operations 4 paths 10 schemas 2 GET3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
2.0
Base URL
https://api.ripple.com
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Ripple Labs Request for payment API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (TokenAuth). By default, every request must be authenticated.

Paths & Operations 5

Across 4 paths, the API surfaces 5 operations — 2 GET, 3 POST. Each is listed below with its method, path, parameters, and response codes.

Request for payment 5

Use these operations to interact with your payment requests. | Operation | Method | Description | | -- | -- | -- | | [Get requests for payment](/products/payments-odl/api-docs/rip…

GET
/request_for_payment
Get requests for payment
getRequestsForPayment 12 params → 200400
POST
/request_for_payment
Send request for payment
sendRequestForPayment body → 200400
GET
/request_for_payment/{request_for_payment_id}
Get request for payment by ID
getRequestForPaymentById 1 param → 200400
POST
/request_for_payment/{request_for_payment_id}/accept
Accept request for payment
acceptRequestForPayment 1 param body → 200400
POST
/request_for_payment/{request_for_payment_id}/fail
Fail request for payment
failRequestForPayment 1 param body → 200400

Schemas 10

The contract defines 10 schemas that model the data the API accepts and returns. The most detailed are RippleNetNodeRequestForPayment (11 properties), Page (8 properties), RippleNetNodeRequestForPaymentRequest (7 properties), Sort (6 properties). Each schema is shown below with its type and property counts.

Sort
object
6 properties
RippleNetNodeRequestForPaymentRequest
object
Use this JSON object to request a request for payment.
7 properties 5 required
AcceptRequestForPaymentRequest
object
Use this JSON object to accept a request for payment.
2 properties 1 required
FailRequestForPaymentRequest
object
Use this JSON object to fail a request for payment.
1 property
RippleNetNodeRequestForPaymentUserInfo
object
User information provided across the payment lifecycle.
4 properties 1 required
RippleNetNodeRequestsForPayment
Paged response for requests for payment includes:
Page
object
Paginated response base object.
8 properties
UserInfoEntry
object
User information provided as arbitrary key/value pairs.
3 properties 2 required
RippleNetNodeRequestForPayment
object
Use this JSON object represent a request for payment.
11 properties 9 required
RippleNetProblem
object
Represents a request to create and update a payout method record.
6 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

ripple-labs-request-for-payment-api-openapi.yml Raw ↑

Other APIs Ripple Labs publishes across the network.

Ripple Labs Addresses API
Ripple Labs API Credentials API
Ripple Labs Auditing API
Ripple Labs Authentication API
Ripple Labs Balances and statements API
Ripple Labs Balances API
Ripple Labs Beneficiary confirmation API
Ripple Labs Counterparties API
Ripple Labs Diagnostics API
Ripple Labs Exchange transfers API
Ripple Labs Fees API
Ripple Labs Liquidations API