Skip to main content
POST
/
payments
/
confirm
Confirm a payment
curl --request POST \
  --url https://v2.prod.halliday.xyz/payments/confirm \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "payment_id": "<string>",
  "state_token": "aSDinaTvuI8gbWludGxpZnk=",
  "owner_address": "<string>",
  "destination_address": "<string>",
  "client_redirect_url": "<string>"
}'
{
  "payment_id": "<string>",
  "status": "PENDING",
  "funded": true,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "initiate_fund_by": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "quote_request": {
    "request": {
      "kind": "FIXED_INPUT",
      "fixed_input_amount": {
        "asset": "ethereum:0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
        "amount": "1"
      },
      "output_asset": "ethereum:0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
    },
    "price_currency": "USD",
    "onramps": [
      "moonpay",
      "coinbase"
    ],
    "onramp_methods": [
      "credit_card",
      "ach",
      "apple_pay"
    ],
    "customer_ip_address": "<string>",
    "customer_id": "<string>",
    "customer_geolocation": {
      "alpha3_country_code": "<string>",
      "state_code": "<string>"
    },
    "parent_payment_id": "<string>"
  },
  "quoted": {
    "output_amount": {
      "asset": "ethereum:0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "amount": "1"
    },
    "fees": {
      "total_fees": "<string>",
      "conversion_fees": "<string>",
      "network_fees": "<string>",
      "business_fees": "<string>",
      "currency_symbol": "USD"
    },
    "onramp": "<string>",
    "onramp_method": "credit_card",
    "route": [
      {
        "type": "ONRAMP",
        "net_effect": {
          "consume": [
            {
              "account": "USER",
              "resource": {
                "asset": "<any>",
                "property": "<any>"
              },
              "amount": {
                "amount": "<any>"
              }
            }
          ],
          "produce": [
            {
              "account": "USER",
              "resource": {
                "asset": "<any>",
                "property": "<any>"
              },
              "amount": {
                "amount": "<any>"
              }
            }
          ]
        },
        "pieces_info": [
          {
            "type": "onramp"
          }
        ],
        "step_index": 123
      }
    ]
  },
  "fulfilled": {
    "output_amount": {
      "asset": "ethereum:0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "amount": "1"
    },
    "fees": {
      "total_fees": "<string>",
      "conversion_fees": "<string>",
      "network_fees": "<string>",
      "business_fees": "<string>",
      "currency_symbol": "USD"
    },
    "onramp": "<string>",
    "onramp_method": "credit_card",
    "route": [
      {
        "status": "PENDING",
        "type": "ONRAMP",
        "net_effect": {
          "consume": [
            {
              "account": "USER",
              "resource": {
                "asset": "<any>",
                "property": "<any>"
              },
              "amount": {
                "amount": "<any>"
              }
            }
          ],
          "produce": [
            {
              "account": "USER",
              "resource": {
                "asset": "<any>",
                "property": "<any>"
              },
              "amount": {
                "amount": "<any>"
              }
            }
          ]
        },
        "pieces_info": [
          {
            "type": "onramp"
          }
        ],
        "step_index": 123,
        "transaction_hash": "<string>"
      }
    ]
  },
  "current_prices": {
    "USD": "1.00",
    "ethereum:0x": "4200",
    "ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": "1.00"
  },
  "price_currency": "USD",
  "customer_id": "<string>",
  "processing_addresses": [
    {
      "chain": "ethereum",
      "address": "<string>"
    }
  ],
  "owner_address": "<string>",
  "destination_address": "<string>",
  "next_instruction": {
    "type": "ONRAMP",
    "payment_id": "<string>",
    "funding_page_url": "https://app.halliday.xyz/funding/${payment_id}",
    "deposit_info": [
      {
        "deposit_token": "base:0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
        "deposit_amount": "4.8",
        "deposit_address": "0xaddress",
        "deposit_chain": "base"
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
payment_id
string
required

ID of the payment from the quote to confirm

​
state_token
string<byte>
required

State token from the quote response

​
owner_address
string
required

Owner address for the payment. This is the address that the payment will be sent from.

​
destination_address
string
required

Destination address for the payment. This is the address that the payment will be sent to.

​
client_redirect_url
string<uri>

Optional URL to redirect users to after an onramp flow completes.

Response

Payment confirmed successfully

​
payment_id
string
required
​
status
enum<string>
required
Available options:
PENDING,
COMPLETE,
FAILED,
EXPIRED,
WITHDRAWN,
TAINTED
​
funded
boolean
required

Whether the payment has been funded

​
created_at
string<date-time>
required
​
updated_at
string<date-time>
required
​
initiate_fund_by
string<date-time>
required

Deadline for funding the payment.

​
quoted
object
required
​
fulfilled
object
required
​
current_prices
object
required

Mapping of asset symbols to their unit prices

Example:
{
  "USD": "1.00",
  "ethereum:0x": "4200",
  "ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": "1.00"
}
​
price_currency
string
required

Currency that all prices are denominated in

Example:

"USD"

​
processing_addresses
object[]
required
​
owner_address
string
required

Address of the owner of the payment

​
destination_address
string
required

Address of the destination of the payment

​
completed_at
string<date-time>
​
quote_request
object

Optional reference to the original quote request.

​
customer_id
string

ID of the customer who created the payment

​
next_instruction
object

Instruction payload that returns the funding pages if the payment requires funding.

Example:
{
  "type": "ONRAMP",
  "payment_id": "<string>",
  "funding_page_url": "https://app.halliday.xyz/funding/${payment_id}",
  "deposit_info": [
    {
      "deposit_token": "base:0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
      "deposit_amount": "4.8",
      "deposit_address": "0xaddress",
      "deposit_chain": "base"
    }
  ]
}