Step 4: Monitor the payment

After accepting the payment and sharing the link with your customer, you need to monitor its progress. Poll the payment status endpoint every 10–30 seconds to track the payment through its lifecycle.

Make the request

Use include=link to include the payment link in the response, which is useful if you need to reshare it with your customer.

curl -i -X GET \
  'https://api-sandbox.equalsmoney.com/stablecoins/payments/{paymentId}?accountId={accountId}&include=link' \
  -H 'Authorization: ApiKey {apiKey}'

curl -i -X GET \
  'https://api.equalsmoney.com/stablecoins/payments/{paymentId}?accountId={accountId}&include=link' \
  -H 'Authorization: ApiKey {apiKey}'

Payment status lifecycle

As the payment progresses, the status field will change:

Status	Meaning
`PENDING`	Payment created and accepted, waiting for the remitter to send USDC
`PROCESSING`	USDC transfer has been detected on the blockchain and is being processed
`COMPLETE`	Payment successfully processed — funds have been credited to your budget
`CANCELLED`	Payment processing was cancelled
`EXPIRED`	The remitter didn’t complete the transfer before the payment expired

Expected response (completed)

When the payment has been successfully processed, you’ll see status: "COMPLETE":

200 OK

{
  "id": "e9293471-5eb3-4dbc-916c-dbaf9e2deefd",
  "accountId": "F50091",
  "budgetId": "775596ae-2624-40af-a9dc-9756110a4a03",
  "status": "COMPLETE",
  "remitterId": "a1111111-2222-3333-4444-555555555555",
  "amount": 100,
  "displayName": "Invoice #12345",
  "sourceCurrencyCode": "USDC",
  "destinationCurrencyCode": "USD",
  "returnUrl": "https://www.example.com/payment-complete",
  "link": {
    "url": "https://pay.sandbox.example.com/channel?uuid=9d1f67f2-a647-404b-9b02-247c77be81d0",
    "chains": [
      {
        "protocol": "ETH",
        "address": "0x0000000000000000000000000000000000000000"
      }
    ]
  },
  "expiresAt": "2025-01-30T10:00:00.000Z",
  "createdBy": "John Smith",
  "createdAt": "2025-01-30T09:00:00Z",
  "updatedAt": "2025-01-30T09:00:00Z"
}

Once the status is COMPLETE, the converted USD funds are available in your budget.

If a payment expires or fails, you’ll need to create a new payment and accept it again. See Manage stablecoin inbound payments for more details.

​Step 4: Monitor the payment

​Make the request

​Payment status lifecycle

​Expected response (completed)

Step 4: Monitor the payment

Make the request

Payment status lifecycle

Expected response (completed)