syntax = "proto3";

package payments.payment.v1;

option go_package = "github.com/tech/sendico/pkg/proto/payments/payment/v1;paymentv1";

import "api/proto/payments/transfer/v1/transfer.proto";

// PaymentIntent describes the full intent for an external payment,
// wrapping a transfer with payer/payee identity and purpose.
message PaymentIntent {
  // transfer is the underlying value movement.
  payments.transfer.v1.TransferIntent transfer = 1;
  // payer_ref identifies the entity funding the payment.
  string payer_ref = 2;
  // payee_ref identifies the payment beneficiary.
  string payee_ref = 3;
  // purpose is a human-readable description of the payment reason.
  string purpose = 4;
}