Trigger a forward payment against an advanced invoice.
Use this endpoint when the customer has already paid you outside Resolve and you want Resolve to collect its portion from the forwarded amount.
Create a forward payment against an advanced invoice.
Send this request when a customer has already paid you outside Resolve and you need to forward the payment to Resolve.
Reason code for the forward payment.
This is the field that triggers the forward-payment flow.
- Mock serverhttps://docs.resolvepay.com/_mock/merchant-api/openapi/payments
- Sandbox serverhttps://app-sandbox.resolvepay.com/api/payments
curl -i -X POST \
https://docs.resolvepay.com/_mock/merchant-api/openapi/payments \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"invoice_id": "PMMlaE5wbg0",
"amount": 500,
"forward_reason_code": "wire",
"forward_reason_message": "Customer paid by wire transfer outside Resolve."
}'An object representing a payment.
Source of the payment.
Method of payment made by the customer.
Status of the payment.
pending- Payment is pending processing.in_transit- Payment has been processed and is in transit.in_review- Payment is being reviewed.paid- Payment has been confirmed and applied to the customer's account.failed- Payment failed confirmation (e.g., bank transfer or credit card payment rejected).canceled- Payment was canceled by request.
Date the payment was confirmed by Resolve and applied to the customer's account.
Date the payment was processed by Resolve.
Date the payment was scheduled for processing, if applicable.
Reason code for a forward payment.
Use this field to trigger the forward-payment flow. A forward payment is how you tell Resolve that the customer already paid you and that Resolve should collect its portion from the forwarded amount.
Free-form reason text for a forward payment.
Required when forward_reason_code is other.
{ "id": "PMMlaE5wbg0", "customer_id": "X50sgfRd", "source": "customer_user", "amount": 1000, "method": "ach_debit", "status": "paid", "created_at": "2020-01-01T00:00:00.730Z", "paid_at": "2020-01-02T00:00:00.730Z", "canceled_at": null, "failed_at": null, "processed_at": "2020-01-01T12:00:00.730Z", "scheduled_at": null, "processing_fee": 25.5, "canceled_code": null, "failed_code": null, "dispute_code": null, "forward_reason_code": "check", "forward_reason_message": "Customer paid by wire transfer outside Resolve.", "payment_links": [ { … } ], "created_by_user_id": null }