Pay Order

Production server

https://api.petstoreapi.com/v1

POST

/orders/{id}/payment

Process payment for an existing order.

Payment Workflow

Payment processing follows this workflow:

Create Order: First create an order using POST /orders (status: placed)

Submit Payment: Call this endpoint with payment details (card or bank account)

Payment Processing: The payment is processed with status processing

Payment Result:

Success: Payment status becomes succeeded, order status updates to approved

Failure: Payment status becomes failed, order remains placed and can be retried

Receipt: After successful payment, retrieve the receipt from the order details

Important: This is a synchronous payment operation. For security, sensitive payment data (like CVC codes) are writeOnly and never returned in responses. Card numbers and account numbers are masked when read.

Request

Authorization

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Payment successful

Body

Request Example

Shell

JavaScript

Java

Swift

cURL

Pay by Bank CardPay by Bank Account

curl --location --request POST 'https://api.petstoreapi.com/v1/orders/123456/payment' \
--header 'Content-Type: application/json' \
--data-raw '{
    "amount": 49.99,
    "currency": "GBP",
    "source": {
        "object": "card",
        "name": "J. Doe",
        "number": "4242424242424242",
        "cvc": "123",
        "expMonth": 12,
        "expYear": 2025,
        "addressLine1": "123 Fake Street",
        "addressLine2": "4th Floor",
        "addressCity": "London",
        "addressCountry": "gb",
        "addressPostCode": "N12 9XX"
    }
}'

Response Example

Card Payment

{
    "id": "2e3b4f5a-6b7c-8d9e-0f1a-2b3c4d5e6f7a",
    "amount": 49.99,
    "currency": "GBP",
    "source": {
        "object": "card",
        "name": "J. Doe",
        "number": "************4242",
        "cvc": "123",
        "expMonth": 12,
        "expYear": 2025,
        "addressCountry": "gb",
        "addressPostCode": "N12 9XX"
    },
    "status": "succeeded",
    "links": {
        "order": "https://api.example.com/orders/1725ff48-ab45-4bb5-9d02-88745177dedb/payment"
    }
}

Modified at 2025-12-19 04:10:45

Pay for an Order

Create Chat Completion

Pay Order

Payment Workflow#

Request

Responses

Payment Workflow