Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions changelog/api.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -78,9 +78,9 @@ Filtering needs knowledge of the available categories. You can now fetch the ful

<Update label="March 2025" tags={["Feature", "Payment", "Ordering"]}>
## New payment payout type added
To support the release of [Runa Pay to Card](https://runa.io/products/pay-to-card) a new payout type of `payment` has been added to the product catalog. This new type joins the existing types of `gift_card` and `subscription`. For `payment` type products the new `payment` key will contain specific details about the product.
To support the release of [Runa Push to Card](https://runa.io/products/push-to-card) a new payout type of `payment` has been added to the product catalog. This new type joins the existing types of `gift_card` and `subscription`. For `payment` type products the new `payment` key will contain specific details about the product.

[Runa Pay to Card](https://runa.io/products/pay-to-card) enables you to push funds to global cards and bank accounts instantly. Funds can be sent instantly to billions of users in 190 countries, powered by Visa Direct and Mastercard. Existing customers should contact their account manager for more details.
[Runa Push to Card](https://runa.io/products/push-to-card) enables you to push funds to global cards and bank accounts instantly. Funds can be sent instantly to billions of users in 190 countries, powered by Visa Direct and Mastercard. Existing customers should contact their account manager for more details.

### Updated endpoints

Expand Down
20 changes: 16 additions & 4 deletions docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -66,12 +66,12 @@
"features/merchant-selection-template",
"features/embedded-fx",
{
"group": "Pay to Card",
"group": "Push to Card",
"icon": "boxes-stacked",
"pages": [
"features/pay-to-card/introduction",
"features/pay-to-card/testing",
"features/pay-to-card/support"
"features/push-to-card/introduction",
"features/push-to-card/testing",
"features/push-to-card/support"
]
}
]
Expand Down Expand Up @@ -221,6 +221,18 @@
"options": ["copy", "view", "chatgpt", "claude"]
},
"redirects": [
{
"source": "/features/pay-to-card/introduction",
"destination": "/features/push-to-card/introduction"
},
{
"source": "/features/pay-to-card/support",
"destination": "/features/push-to-card/support"
},
{
"source": "/features/pay-to-card/testing",
"destination": "/features/push-to-card/testing"
},
{
"source": "/changelog/2023-01-16-api-version-no-longer-available",
"destination": "/changelog/api#2023-01-16-api-version-end-of-life"
Expand Down
Original file line number Diff line number Diff line change
@@ -1,26 +1,26 @@
---
title: "Using Pay to Card"
title: "Using Push to Card"
description: "Provide faster access to funds for your recipients by pushing funds to cards."
icon: "credit-card"
---

Powered by Visa Direct and Mastercard Send, Runa Pay to Card is the fastest and simplest way to send funds directly to your recipients' bank account.
Powered by Visa Direct and Mastercard Send, Runa Push to Card is the fastest and simplest way to send funds directly to your recipients' bank account.

Pay to Card facilitates instant transfers to other accounts, powering use cases like gig worker payments, rewards, incentives, insurance claims, corporate rebates, payroll, government aid, and reimbursements.
Push to Card facilitates instant transfers to other accounts, powering use cases like gig worker payments, rewards, incentives, insurance claims, corporate rebates, payroll, government aid, and reimbursements.

<Info>
To get access to Pay to Card, please reach out to your Account Manager or
To get access to Push to Card, please reach out to your Account Manager or
email support@runa.io.
</Info>

## Fetching the Pay to Card products
## Fetching the Push to Card products

Retrieve the Pay to Card products using the [product list endpoint](/reference/2024-02-05/endpoint/products/list). You can identify these products by the `payout_type` field, which will be set to `payment`. Each Pay to Card product supports a specific currency and country. You can refer to the [product listing guide](/features/product-catalog) for more information on this endpoint.
Retrieve the Push to Card products using the [product list endpoint](/reference/2024-02-05/endpoint/products/list). You can identify these products by the `payout_type` field, which will be set to `payment`. Each Push to Card product supports a specific currency and country. You can refer to the [product listing guide](/features/product-catalog) for more information on this endpoint.

```json title="Pay to Card product example, fields truncated for brevity" icon="file" expandable
```json title="Push to Card product example, fields truncated for brevity" icon="file" expandable
{
"code": "P2C-US",
"name": "Pay To Card US",
"name": "Push To Card US",
"currency": "USD",
"state": "LIVE",
"payout_type": "payment",
Expand All @@ -29,13 +29,13 @@ Retrieve the Pay to Card products using the [product list endpoint](/reference/2
}
```

## Placing a Pay to Card order
## Placing a Push to Card order

To make an order for a payment you simply specify the Pay to Card product code for the currency and country you wish to send funds in.
To make an order for a payment you simply specify the Push to Card product code for the currency and country you wish to send funds in.

For our example, we will be using the `P2C-US` product code for a $10 payment to a recipient. The payment will be sent to the recipient's email address via the `EMAIL` distribution method.

```http title="Example pay to card order" icon="globe" expandable
```http title="Example push to card order" icon="globe" expandable
POST https://api.runa.io/v2/order
Content-Type: application/json
X-Api-Key: <your API key>
Expand Down Expand Up @@ -86,10 +86,10 @@ For a returning recipient, they will only need to enter their email address to a
## Next steps

<CardGroup cols="2">
<Card title="Testing" icon="flask" href="/features/pay-to-card/testing">
Test out the pay to card redemption journey in our playground environment.
<Card title="Testing" icon="flask" href="/features/push-to-card/testing">
Test out the push to card redemption journey in our playground environment.
</Card>
<Card title="Support" icon="circle-info" href="/features/pay-to-card/support">
<Card title="Support" icon="circle-info" href="/features/push-to-card/support">
Read through the potential failure scenarios and suggested resolution for
each.
</Card>
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Support"
description: "Potential error scenarios for Pay to Card and their resolution."
description: "Potential error scenarios for Push to Card and their resolution."
icon: "circle-info"
---

Expand Down
Original file line number Diff line number Diff line change
@@ -1,17 +1,17 @@
---
title: "Testing"
description: "Steps to simulate different pay to card redemption scenarios in playground."
description: "Steps to simulate different push to card redemption scenarios in playground."
icon: "flask"
---

The Pay to Card redemption journey requires a few steps from the recipient. To test this journey in the playground environment, you can use the following steps.
The Push to Card redemption journey requires a few steps from the recipient. To test this journey in the playground environment, you can use the following steps.

<Info>
For testing and simulating errors during placing of the order, refer to the
[playground reference section](/docs/playground).
</Info>

Here's a high level summary of the Pay to Card redemption journey:
Here's a high level summary of the Push to Card redemption journey:

<img className="block dark:hidden" src="/assets/graphics/p2c-flow-light.png" />
<img className="hidden dark:block" src="/assets/graphics/p2c-flow-dark.png" />
Expand Down
2 changes: 1 addition & 1 deletion introduction.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ mode: "wide"

## Runa at a glance

Runa is the infrastructure and network for global payouts – gift cards, prepaid cards, and pay-to-card – all managed from a single, unified platform. Deliver funds instantly to recipients worldwide with enterprise-grade reliability, security, and scale.
Runa is the infrastructure and network for global payouts – gift cards, prepaid cards, and push-to-card – all managed from a single, unified platform. Deliver funds instantly to recipients worldwide with enterprise-grade reliability, security, and scale.

The Runa API lets you automate and embed payouts directly into your app or workflow. Whether you're sending one or one million, Runa handles the complexity so you don't have to.

Expand Down
Loading