Payment Embed

Overview

This guide demonstrates how to integrate the Anyway payment interface into your application using the payment URL from the subscription setup response.

API Response Structure

When you successfully create a subscription setup, you'll receive a response containing the payment URL and related details:

{
  "success": true,
  "message": "Subscription setup created successfully. Redirect customer to setup_url.",
  "data": {
    "paymentUrl": "https://payment.dev.anyway.sh/pay?token=eyJhbGciOiJIUzM4NCJ9.eyJvcmRlcklkIjoiT1JEMjUxMDIzMDMyNjE5MTQzMDNOMVZOT0kzMSIsIm1lcmNoYW50SWQiOiJPUkcyNUcxTDhUQjVHMDNOMSIsInR5cGUiOiJzdWJzY3JpcHRpb25fc2V0dXAiLCJzdWJzY3JpcHRpb25JZCI6IlNVQjI1MTAyMzAzMjYxOTE0MzAzTjFWTk9JMzEiLCJzdWIiOiJPUkQyNTEwMjMwMzI2MTkxNDMwM04xVk5PSTMxIiwiaWF0IjoxNzYxMTYxMTgwLCJleHAiOjE3NjExNjQ3ODB9.7HYt-Nx-VJV2rem2HmDyKFSWUWa8VaU5GgssJkqMivTL50AsjCUlaOxWRVNIgPwc",
    "orderId": "ORD25102303261914303N1VNOI31",
    "setupJwtToken": null,
    "subscriptionId": "SUB25102303261914303N1VNOI31",
    "status": "PENDING",
    "expiresIn": 3600000
  },
  "error": null
}

Response Fields

Field	Type	Description
`paymentUrl`	string	The URL to redirect customers to complete payment setup
`orderId`	string	Unique identifier for the order
`subscriptionId`	string	Unique identifier for the subscription
`status`	string	Current status of the payment setup (e.g., PENDING)
`expiresIn`	number	Token expiration time in milliseconds (default: 1 hour)

Integration Instructions

Redirect Method

Redirect your customer to the paymentUrl to complete the payment setup:

Embed Method (iframe)

Alternatively, embed the payment interface directly in your application using an iframe:

Note: Replace YOUR_TOKEN_HERE with the actual token from the paymentUrl response.

Testing

Test Card Numbers

Use the following test card numbers in the development environment:

Card Type	Card Number	CVV	Expiry
VISA	`4035 5010 0000 0008`	Any 3 digits	Any future date
MASTERCARD	`2223 0000 4841 0010`	Any 3 digits	Any future date
AMEX	`3706 3680 3809 394`	Any 4 digits	Any future date

Testing Tips

Use any future expiration date (e.g., 12/25)

Use any valid CVV/CVC code

Test cards will simulate successful payments in the development environment

Important Notes

⚠️ Token Expiration: The payment URL token expires after 1 hour (3600000ms). Generate a new subscription setup if the token has expired.

⚠️ Security: Never expose your API keys or store them in client-side code.

Overview#

API Response Structure#

Response Fields#

Integration Instructions#

Redirect Method#

Embed Method (iframe)#

Testing#

Test Card Numbers#

Testing Tips#

Important Notes#